List bills
Changed onList bills, soonest due first; bills without a due date come first, and bills due the same day are ordered by id. Add includeSummary=true for totals and an accounts payable aging report.
Request
- Base URLhttps://api.slash.com
- URLhttps://api.slash.com/v2/bills
- AuthAPI key in header X-API-Key
Query parameters
The opaque metadata.nextCursor value from the previous page. It carries that page's filters, page size and ordering, so pass it on its own; see Pagination.
Number of items per page, from 1 to 100. The page size is carried inside metadata.nextCursor, so later pages keep the same size unless limit is passed again to change it.
Return only bills in these statuses.
Return only bills for one vendor, a recipient.
Return only bills with exactly this invoice number. Invoice numbers aren't unique, so combine it with recipientId to find one vendor's invoice.
Return only bills owned by one user.
Return only bills that entered Slash this way.
true returns only unpaid bills whose due date has passed; false excludes them.
true returns only bills with at least one document attached; false only bills without one.
Return only bills due on or after this YYYY-MM-DD date.
Return only bills due on or before this YYYY-MM-DD date.
Return only bills invoiced on or after this YYYY-MM-DD date.
Return only bills invoiced on or before this YYYY-MM-DD date.
Return only bills whose total is at least this many minor units.
Return only bills whose total is at most this many minor units.
true adds a summary with the count, total, outstanding balance, and aging buckets of every bill the filters match, not just the current page, one entry per currency.
Response
A page of bills.
Example response
{
"items": [
{
"id": "bill_2rj4l7hmrrrcv",
"recipientId": "le_c_2rj4l7hmrrrcv",
"destinationId": "le_contact_destination_2rj4l7hmrrrcv",
"ownerUserId": "u_2rj4l7hmrrrcv",
"invoiceNumber": "INV-4471",
"invoiceDate": "2026-09-01",
"dueDate": "2026-10-01",
"currency": "USD",
"lineItems": [
{
"id": "bill_line_item_2rj4l7hmrrrcv",
"name": "Hosting",
"quantity": 1
}
],
"documentIds": [
"st_2rj4l7hmrrrcv"
],
"payments": [
{
"id": "bill_payment_2rj4l7hmrrrcv",
"transferId": "transfer_intent_2rj4l7hmrrrcv",
"transactionId": "agg_tx_2rj4l7hmrrrcv"
}
]
}
],
"summary": {
"asOf": "2026-09-19",
"currencies": [
{
"currency": "USD",
"count": 12,
"aging": {
"current": {
"count": 3
},
"1_30": {
"count": 3
},
"31_60": {
"count": 3
},
"61_90": {
"count": 3
},
"over_90": {
"count": 3
}
}
}
]
}
}Changes
- info
endpoint added
- info