Skip to main content

Reject Bill Payment Request

POST 

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

Reject a landed-cost bill's pending payment request. The bill stays unpayable under the policy until a new request is approved; it can be submitted again.

Required scope: purchase-orders:write

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

Fields:

  • reason (optional, string, max 500) — shown to the requester and on the bill

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