Transport Documents

List transport document statuses

List the closed catalog of transport document statuses (draft, issued, closed, cancelled, superseded) with their Spanish label and UI color. Use it to populate filters or status pickers instead of hard-coding values. The response data is an array of { value, label, color } items.

get/companies/{company}/transport-documents/statuses

Request

Base URL: https://api.factuarea.com/v1
URL: https://api.factuarea.com/v1/companies/{company}/transport-documents/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": "issued",
      "label": "Emitido",
      "color": "blue"
    }
  ]
}

Changes

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