Expenses

List expense reports (module status)

Polling snapshot: the same current record or collection as the corresponding read endpoint, including its state and progress. List filters, defaults and pagination also apply here. This is not an event history or a changes-since feed. Poll at a sensible interval (start with 30 seconds), respect Retry-After on 429 and stop when the required terminal state is reached.

Note spese, newest first, with the three totals each one froze and how many lines it holds. status is the story: draft is still being filled in, submitted is waiting for a decision, rejected came back and is editable again, approved is signed off and reimbursed is paid and final. This is where the ids the other report tools take come from. Paged with cursor.

Examples

  • A che punto sono le mie note spese? GET /api/v1/rest/spese/status
  • Quali note spese aspettano ancora una risposta? GET /api/v1/rest/spese/status?status=submitted
  • Quante note spese dell’azienda sono da pagare? GET /api/v1/rest/spese/status?scope=company&status=approved&limit=50
get/api/v1/rest/spese/status

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/spese/status
  • Auth: HTTP bearer

Query parameters

status'draft' | 'submitted' | 'approved' | 'rejected' | 'reimbursed'

Only reports in this state.

querystring

Free text over the report’s name. At least two characters.

scope'own' | 'company'

own (default) is the caller’s own spending. company is everybody’s and needs the spese:company:read grant; without it this is refused rather than narrowed.

owner_user_idstring uuid

Narrow a company-scoped read to one colleague. From custodo_list_members.

limitinteger

Rows to return, 1–100. Default 20.

cursorstring

Opaque cursor from a previous call’s nextCursor, to continue.

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Response

Done. data is the tool’s answer, as described here. Its objects may carry fields this description does not name yet: read the ones you need and ignore the rest.

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.