Invoices

List invoice statuses

Lists the closed catalog of invoice statuses with their public value, localized label, and UI color. Use it to populate filters or status pickers instead of hard-coding values.

get/companies/{company}/invoices/statuses

Request

Base URL: https://api.factuarea.com/v1
URL: https://api.factuarea.com/v1/companies/{company}/invoices/statuses
Auth: one of:
- HTTP bearer
- API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Headers

Factuarea-Versionstring date

Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

Example response

{
  "data": [
    {
      "value": "paid",
      "label": "Pagado",
      "color": "green"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.