Sign in
invoices

Retrieve the approval policy chain for a specific invoice

Returns the ordered policy chain for an invoice, including hierarchical child policies, per-tier status, and approver rows. Use to render multi-tier Advanced Approval workflows with active/blocked/completed tiers.

Note: response is a bare JSON array (no version wrapper). The childrens field name intentionally matches the backend serializer's spelling.

get/invoices/{id}/approval-chain

Path parameters

idstring required

Ottimate invoice ID

Query parameters

sync_approvalboolean

When true, re-applies policies before returning the chain (default false). Only effective when the invoice is not exported.

Headers

Authorizationstring required

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-Keystring required

API key for authentication

X-API-Versionstring

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.

Response

Successful response with the ordered approval policy chain

InvoicesGetInvoicesIdApprovalChainResponse200 required

Empty response body

Changes