List invoices

GET

/v1/finance/invoices

• Production

Cursor-paginated invoices with an outstanding (sent/overdue) summary per currency (read-only). Requires scope finance:read.

Authorizations

• bearerAuth

Parameters

Query Parameters

after

integer

limit

integer

default: 25 >= 1 <= 100

status

string

Allowed values: draft sent paid overdue cancelled

Responses

200

Paginated invoice list with outstanding totals.

object

items

Array<object>

object

id

integer

invoiceNumber

string

status

string

Allowed values: draft sent paid overdue cancelled

currency

string

total

number

contactId

integer

nullable

issueDate

string format: date-time

dueDate

string format: date-time

nullable

paidAt

string format: date-time

nullable

nextCursor

integer

nullable

hasMore

boolean

outstanding

Array<object>

object

currency

string

count

integer

total

number

401

Missing or invalid bearer token.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "unauthorized",
  "message": "Invalid bearer principal"
}

403

The API key does not have the required scope for this operation.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "forbidden",
  "message": "scope contacts:write is required"
}