# Everything sent but not yet paid
curl 'https://api.stateset.com/api/v1/invoices?status=sent&limit=50' \
-H 'Authorization: Bearer <token>'
curl 'https://api.stateset.com/api/v1/invoices?overdue_only=true' \
-H 'Authorization: Bearer <token>'
{
"data": [
{
"invoice_id": "inv_1234567890",
"status": "sent",
"total_amount": { "value": "12000.00", "denom": "ssusd" },
"amount_paid": { "value": "5000.00", "denom": "ssusd" },
"balance_due": { "value": "7000.00", "denom": "ssusd" }
}
],
"total": 128
}
List Invoices
List invoices, filtered by status, counterparty, or date, with cursor pagination.
GET
/
api
/
v1
/
invoices
# Everything sent but not yet paid
curl 'https://api.stateset.com/api/v1/invoices?status=sent&limit=50' \
-H 'Authorization: Bearer <token>'
curl 'https://api.stateset.com/api/v1/invoices?overdue_only=true' \
-H 'Authorization: Bearer <token>'
{
"data": [
{
"invoice_id": "inv_1234567890",
"status": "sent",
"total_amount": { "value": "12000.00", "denom": "ssusd" },
"amount_paid": { "value": "5000.00", "denom": "ssusd" },
"balance_due": { "value": "7000.00", "denom": "ssusd" }
}
],
"total": 128
}
Overview
Returns a page of invoices. The common uses are finding what is outstanding and finding what is overdue — those are different queries, and only the second one is about time.Query
integer
Maximum results to return. Defaults to 50.
integer
Number of results to skip. Defaults to 0.
string
Filter by customer ID (UUID).
string
Filter by order ID (UUID).
string
Filter by status:
draft, sent, viewed, paid, overdue, or voided.string
Filter by type:
standard, credit_note, pro_forma, or recurring.boolean
Return only overdue invoices.
string
Invoices created on or after this date (RFC 3339).
string
Invoices created on or before this date (RFC 3339).
Response
array
required
The invoices, each shaped as in Get Invoice.
integer
Total matching invoices, for computing how many pages remain.
Errors
Succeeds with200. Failures return 400, 401, 403 or 429 with an error body, per the platform status-code contract.
# Everything sent but not yet paid
curl 'https://api.stateset.com/api/v1/invoices?status=sent&limit=50' \
-H 'Authorization: Bearer <token>'
curl 'https://api.stateset.com/api/v1/invoices?overdue_only=true' \
-H 'Authorization: Bearer <token>'
{
"data": [
{
"invoice_id": "inv_1234567890",
"status": "sent",
"total_amount": { "value": "12000.00", "denom": "ssusd" },
"amount_paid": { "value": "5000.00", "denom": "ssusd" },
"balance_due": { "value": "7000.00", "denom": "ssusd" }
}
],
"total": 128
}
This endpoint paginates with
limit and offset, not a cursor. Offset paging over a set that is
changing underneath you can skip or repeat rows — invoices move between sent, paid, and
overdue continuously. Narrow with status or a from_date/to_date window so each page is drawn
from a more stable set, and treat a full walk as approximate rather than exact.Related
- Get Invoice
- Create Invoice
- Finance — factor what is outstanding
Last modified on August 29, 2026