---
title: "List invoice statuses"
method: GET
path: "/invoice/statuses"
tags: ["Invoice"]
---

# List invoice statuses

`GET /invoice/statuses`

Returns the invoice status values, API keys, labels, and descriptions used by the invoice endpoints.

## Response `200`

OK

- InvoiceStatusesResponse
  - `success` true, required
  - `statuses` StatusDefinition[], required
    - `status` string, required — Numeric status value returned on the corresponding invoice or order resource.
    - `status_key` string, required — Stable API key accepted by status-filter endpoints.
    - `status_label` string, required — Human-readable status label.
    - `description` string, required — Meaning of the status.

## Other responses

- `401` — Missing or invalid API key
- `403` — Authenticated key does not have permission for this endpoint

---

[API](https://skmtc.net/b-cdn/apis/billingserv-api-v2.md) · [All operations](https://skmtc.net/b-cdn/apis/billingserv-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b-cdn/billingserv-api-v2/revisions/76cfbed5eb40/schema)