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

# List invoice statuses

`GET /invoice/statuses`

## Request

- Base URL: `https://demo.onlinebillingform.com/api/v2`
- URL: `https://demo.onlinebillingform.com/api/v2/invoice/statuses`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/billingserv/apis/billingserv-api-v2/docs/invoice/statuses/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-08-22** `76cfbed5eb40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/billingserv/apis/billingserv-api-v2/changes/invoice/statuses/get.md)

---

[API](https://skmtc.dev/billingserv/apis/billingserv-api-v2.md) - [All operations](https://skmtc.dev/billingserv/apis/billingserv-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/billingserv/apis/billingserv-api-v2/revisions/232ab5ca8413?raw)