Skip to main content
GET
List bills

Authorizations

x-dolfin-api-key
string
header
required

An API key issued to your client. It carries the client's scope; org-scoped calls also require the x-dolfin-organisation-id header. Keys are created and revoked by a client administrator.

Headers

x-dolfin-organisation-id
string<uuid>

Target organisation. Required when authenticating with an API key; omit for Bearer callers (resolved from the token).

Query Parameters

Cursor
string
Limit
default:20
States
enum<string>[]
Available options:
Created,
Extracting,
PendingReview,
NeedsApproval,
Approved,
Rejected,
Scheduled,
Paid,
ExtractionFailed,
PaymentInProgress,
PaymentFailed,
Voided,
OcrProcessing,
OcrFailed
SupplierId
string<uuid>
InvoiceNumber
string
Tag
string
DueDateFrom
string<date-time>
DueDateTo
string<date-time>
IncludeMatch
boolean
default:false

Populate matchSummary on each bill in the response — its three-way match status and the purchase orders and delivery notes it is matched to. Off by default: it costs two extra lookups for the page and is only meaningful for organisations that raise purchase orders. For per-line variances and match suggestions, fetch a bill's match group instead.

Duplicate
boolean

Filter by whether the bill was flagged as a possible duplicate of an earlier bill: true returns only flagged bills (the possible-duplicates queue), false only unflagged ones. Omit for all bills. Flagged bills that were since confirmed as not duplicates are still included by true, since they keep their link to the other bill.

Response

OK

data
object[]
meta
object