GET /billing/invoices
Updated Oct 1, 20261 minute read
List invoices
Owners and admins only. Newest first.
Part of Billing.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | No | Invoices per page. |
cursor | query | string | No | Continuation cursor from the previous page. |
Responses
| Status | Description |
|---|---|
200 | A page of invoices. |
400 | The request is malformed, and the message names the field. |
401 | The bearer token is missing, revoked, or expired. |
403 | The token's person does not hold the role this needs. |
429 | Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
page | object[] | Yes | |
page[].id | string | No | |
page[].status | string | No | |
page[].amountPaidCents | integer | No | |
page[].amountDueCents | integer | No | |
page[].currency | string | No | |
page[].occurredAt | number | No | |
page[].hostedUrl | string | null | No | |
isDone | boolean | Yes | |
continueCursor | string | Yes |
Example request
curl https://api.median.sh/v1/billing/invoices \
-H "Authorization: Bearer $BEARER_AUTH"