Skip to main content

Approve Bill Payment Request

POST 

/api/bills/:bill/payment-request/approve

Record your approval of a landed-cost bill's pending payment request. When no request is pending and you may approve its first step, a request is raised and approved in one call. On a multi-step policy a decision that only satisfied your step returns approval_message naming who it waits on next.

Required scope: purchase-orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Fields:

  • notes (optional, string, max 1000) — approver note recorded with the decision

Authentication: Requires Bearer token.

Answers the bill (same shape as Get Bill) with its updated payment_approval_status and approval summary. Returns 409 approval_state_conflict when the tenant's bill payment approval policy is off — without the policy, landed-cost bills are paid without a payment request. The one bill payment approval policy covers purchase invoices and landed-cost bills alike.

Returns 403 approval_limit_exceeded when you are not an eligible approver for the bill's tier.

Request​

Responses​

OK

Response Headers
    Content-Type