E127: List PO status types

GET /api/purchase-order-status-types

Returns the fixed set of purchase-order statuses. Triggered from filter dropdowns and status selectors.

PO statuses are L1 ENUM values (org.po_status), not user-editable rows. Changing the set is a schema migration.

Authentication

Standard tenant route. Requires Authorization: Bearer <firebase-id-token> and X-Org-Id: <org-id>. Access: Member.

Request

No body. No pagination (bounded fixed set).

Response — 200 OK

{ "data": ["Planning", "Placed", "In Transit", "Partial", "Received", "Paid", "Cancelled"] }

Errors

Standard envelope only.

Workflow

Calls W127 List PO status types.