Skip to main content
POST
Mark supplier bill as paid

Overview

Records a payment on the supplier bill. Pass payment_amount lower than the bill total to record a partial payment (status becomes partial). When the amount is omitted, the full tax_inclusive total is used. payment_date defaults to today.

Linked expense

If the bill is linked to a FirmExpense, that expense is kept in sync — its is_paid flag and paid_at date are updated to match.

Authorizations

Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Path Parameters

id
string
required

Body

application/json
payment_date
string<date>

Defaults to today.

payment_amount
number<float>

Defaults to the bill's tax_inclusive total. A value lower than the total marks the bill partial; zero marks it unpaid.

Required range: x >= 0

Response

Bill updated

success
boolean
data
object
meta
object