Skip to main content

Submit Bill Payment Request

POST 

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

Raise a payment request for a landed-cost bill's outstanding balance under the bill payment approval policy. It routes to the approvers of the matching tier; when you could approve every step yourself it completes in the same call. A bill that already has an approved amount can be submitted again for an increase — the earlier approval keeps covering what it authorized.

Required scope: purchase-orders:write

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

No request body.

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.

Request​

Responses​

OK

Response Headers
    Content-Type