Skip to content
Hoursmith Docs
APIReferenceReports

Uninvoiced work (ready to invoice)

Uninvoiced work (ready to invoice). Billable work not yet invoiced, per client and project: hourly time (stopped entries only: running timers and zero-length entries are left out; value at the current rate, each entry rounded up to 15 minutes), billable expenses and remaining fixed-fee balances, with per-currency totals. from/to filter time-entry and expense dates; fixed-fee balances are CURRENT balances and are not date-filtered. Amounts are advisory estimates. Paged by client. Owner, Admin or Manager only: a Member token gets 403. Plan: Studio or Agency (reports); otherwise 402. Read-only; requires a token with read scope. Unknown or repeated (non-list) query parameters, impossible dates and inverted ranges return 422 with `fields`. Money is an exact decimal string paired with its currency; amounts in different currencies are never added together and nothing is converted. Responses are private (Cache-Control: private, no-store; Vary: Authorization).

GET
/reports/uninvoiced

Authorization

BearerAuth
AuthorizationBearer <token>

Personal Access Token. Mint at Settings → API. Token shape: hsk_<env>_<prefix12>_<secret32>.

In: header

Query Parameters

from?string

Inclusive start (work date), YYYY-MM-DD.

to?string

Inclusive end (work date), YYYY-MM-DD. Must not be before from (422).

clientId?array<>

Filter by client. Repeat the parameter for several (max 25). Unknown ids return 404.

page?integer

1-based page (default 1). A page past the end returns an empty page.

perPage?integer

Rows per page (default 25).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/reports/uninvoiced"
{  "data": {    "range": {      "from": "2019-08-24",      "to": "2019-08-24"    },    "clientIds": [      "c055e856-96a7-4f69-80a6-b75690833d98"    ],    "totals": [      {        "currency": "str",        "total": "string",        "timeAmount": "string",        "fixedFeeAmount": "string",        "expenseAmount": "string",        "seconds": 0,        "expenseCount": 0      }    ],    "clients": [      {        "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",        "clientName": "string",        "currency": "str",        "total": "string",        "timeAmount": "string",        "seconds": 0,        "entryCount": 0,        "expenseAmount": "string",        "expenseCount": 0,        "fixedFeeAmount": "string",        "fixedProjectCount": 0,        "projects": [          {            "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",            "projectName": "string",            "rateType": "HOURLY",            "amount": "string",            "seconds": 0,            "roundedHours": "string",            "hourlyRate": "string",            "fixedFeeAmount": "string",            "draftReservedAmount": "string",            "fixedFeeBillingInitialized": true          }        ]      }    ],    "entryCount": 0,    "expenseCount": 0,    "pagination": {      "page": 0,      "perPage": 0,      "total": 0,      "totalPages": 0,      "hasMore": true    }  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
{  "error": {    "code": "unauthenticated",    "message": "string",    "fields": {      "property1": "string",      "property2": "string"    },    "requiredPlan": "studio",    "feature": "string",    "requestId": "string"  }}
Was this page helpful?

Time summary

Totals and grouped subtotals of tracked time. groupBy day|week|month|client|project|task|member (weeks start Monday); groups are paged. Omit from and to for the previous calendar month in the caller's timezone; from alone runs through today; to without from is a 422. Billable = billable time on HOURLY projects. Owner/Admin/Manager responses include estimatedBillable per client currency (each entry rounded up to 15 minutes at the project's current rate). Members see only their own time, only on projects they currently belong to, and never money, and a userId other than their own is a 404. Any role. Plan: Studio or Agency (reports); otherwise 402. Read-only; requires a token with read scope. Unknown or repeated (non-list) query parameters, impossible dates and inverted ranges return 422 with `fields`. Money is an exact decimal string paired with its currency; amounts in different currencies are never added together and nothing is converted. Responses are private (Cache-Control: private, no-store; Vary: Authorization).

Receivables summary

Accounts receivable per currency: outstanding (SENT invoices' total minus amount paid), overdue (due date before today in the caller's timezone), drafts, paid this month (net received principal by payment date, caller's calendar month) and aging buckets, plus the largest balances per client (max 50 rows). Owner, Admin or Manager only: a Member token gets 403. Plan: Studio or Agency (reports); otherwise 402. Read-only; requires a token with read scope. Unknown or repeated (non-list) query parameters, impossible dates and inverted ranges return 422 with `fields`. Money is an exact decimal string paired with its currency; amounts in different currencies are never added together and nothing is converted. Responses are private (Cache-Control: private, no-store; Vary: Authorization).