List Held Invoices

GET 
/api/v1/connectors/held-invoices

Every invoice a connector is holding for this org, each with its reason.

The same entries GET /connectors carries as held_invoices, but behind invoices:read instead of connectors:manage. The connector page is an administrator's page; the person who can actually correct a held invoice is in finance, works in the Invoice Hub, and holds a role (finance, operations, viewer) that cannot open it. A held invoice never becomes a transaction or a draft, so without this there is no screen on which that person can learn that an invoice they raised went nowhere, or why (2026-09-19).

Read-only, and nothing here is configuration: no connector config, no credentials, no keys — only the org's own invoices and what is wrong with them. Declared before every /{connector_id} route so the literal path is not taken for an id.

Responses

200

Successful Response