List invoices
The team's latest 12 Stripe invoices, newest first, as the billing page lists them: id, number, date, amounts in cents and status.
https://app.usenotix.dev/api/v1/billing/invoicesFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
The team's latest 12 Stripe invoices, newest first, as the billing page lists them: id, number, date, amounts in cents and status. The id is Stripe's own (in_...), since Notix has no other id for an invoice; it opens nothing by itself. The link to pay or download an invoice is not returned: open it from the billing page. A team Stripe has never billed answers an empty list. A Pro month paid from the wallet is a receipt, not a Stripe invoice: see GET /v1/billing/receipts.
Who can call it
A full access or read only key made by someone who is a team admin today (the team owner always is), as the billing page is for admins. A key made by a member answers 403 FORBIDDEN, and so does a key made before Notix recorded who made each key. Send-only and live AI keys answer 403 SCOPE_DENIED; a key limited to one domain answers 403 DOMAIN_PINNED. Every read is recorded in the key's audit log (GET /v1/audit-log).
The team can make 60 billing reads a minute through the API (20 for invoices, which are read from Stripe, within a limit shared by every team); when Notix cannot count them the answer is 503 SERVICE_UNAVAILABLE (try again shortly), never a 429.
Headers
Bearer followed by your API key.
Errors
`SCOPE_DENIED`: a send-only or live AI key. `DOMAIN_PINNED`: a key limited to one domain. `FORBIDDEN`: the key was made by a member who is not a team admin, or before Notix recorded who made each key.
The team read invoices 20 times in the last minute, or Notix's invoice reads across every team are at their limit.
Stripe or the rate counters cannot be reached just now.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/billing/invoices" \
-H "Authorization: Bearer $NOTIX_API_KEY"
import { Notix } from "notix-js";
const notix = new Notix(process.env.NOTIX_API_KEY);
const { data, error } = await notix.billing.invoices();
{
"data": [
{
"id": "cm1x8f3k20001qz7v5b9d2e4a",
"number": "string",
"createdAt": "2026-10-01T10:00:00.000Z",
"amountDue": 1,
"amountPaid": 1,
"currency": "usd",
"status": "paid"
}
]
}