Returns an organization's invoices, newest first. Billing is per organization, so the list covers every project in it. Each invoice carries its total only — there are no line items.
Requires a session JWT and the admin or owner role in the organization. A member gets 403 forbidden ("Only admins can view invoices"), and so does anyone who is not a member of the organization ("Not a member of this organization"). API keys are not accepted on billing endpoints. Any plan.
Query Parameters
orgIdlimit12startingAfterid of the last invoice on the page you already have.Response
dataidin_1Q2w3E4r5T6y7U8i. Pass it as startingAfter to page.numberA1B2C3D4-0007. Falls back to id when the invoice has not been numbered yet.dateamountusd, so 2900 is $29.00.currencyusd.statusopen, paid, void or uncollectible.pdfUrlhostedUrlhasMoretrue when there are older invoices. Fetch them with startingAfter set to the last id in data.An organization that has never had a paid subscription gets { "data": [], "hasMore": false }.
Drafts are removed after a page is fetched, so a page can hold fewer than limit invoices even when hasMore is true. Page on hasMore, not on the page size.
Response — 200 OK
To fetch the next page:
Error Responses
400 Bad Request
Returned when orgId is missing or not a UUID, limit is not an integer from 1 to 100, or startingAfter is empty or longer than 255 characters.
401 Unauthorized
Returned when the Authorization header is missing, or the token is invalid or expired.
403 Forbidden
Returned when you are a member of the organization rather than an admin or owner, or not a member at all.
502 Bad Gateway
Returned when the payment provider could not be reached or returned an error. Retry with backoff.
503 Service Unavailable
Returned when billing is temporarily unavailable. An organization with no billing record still gets the empty list instead.