v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0217204.7 MB
Bill

Create a bill by uploading an invoice

An empty draft bill is created. To upload the invoice, submit a multipart/form-data POST to invoiceUpload.url: add each key/value from invoiceUpload.fields as a form field, then append the file last. Subsequently, the invoice will be parsed and the bill is prefilled with suggestions based on the invoice. The status of parsing can be monitored by either listening for bill.documentUpdated events or polling GET /v1/web/bill/{billId}/document/{id}.

post/v1/web/bill/invoice

Request body

fileNamestring required

Response

Default Response

idstring required
externalIdstring
creatorUserIdstring required
vendorIdstring
invoiceIdstring
currencyCodestring
invoiceDatestring date

ISO date string, YYYY-MM-DD

paymentDueDatestring date

The date that the invoice says the payment is due, in ISO date string, YYYY-MM-DD

totalAmountstring

number string

descriptionstring
paymentScheduledDatestring date

When the payment will be triggered, in ISO date string, YYYY-MM-DD. It should be far enough in advance so when the payment reaches the vendor, it is still before or on the paymentDueDate. Date is based on the payment processor's timezone, i.e. EST.

createdAtstring date-time required
updatedAtstring date-time required
submittedAtstring date-time
completedAtstring date-time
invoiceUploadUrlstring required

Deprecated. Use invoiceUpload instead.