List Bills To Pay
GET/v1/operations/bills.list_to_pay
Lists the organisation's outstanding bills and expense claims (Bills to Pay): supplier, invoice number, type, date, due date, scheduled date, tags, currency, original amount, amount due in the base currency and latest note, with the count and total. Leave filter empty for every outstanding bill. To narrow to one of the organisation's saved Bills to Pay filters, pass its name, or words from its name or description; call bills_list_saved_filters to see them. An unknown or ambiguous filter is answered with the list of filters to choose from.
- Scope
synced.read· reads only- Roles
- Super admin, Admin, Submitter, Custom (by default; an admin can change this per operation)
- MCP tool
bills_list_to_pay
Request
Send the token as Authorization: Bearer. A token approved for several organisations also sends Synced-Organisation: {id} (see Organisations).
Query parameters
| Name | Type | Description |
|---|---|---|
filter | string | Saved filterA saved Bills to Pay filter, by name or words from its description. Leave empty for all bills. |
Response
200 with a JSON body. 401 without a valid token, 403 when the scope, role or organisation does not allow it, 429 when rate limited (see Errors and limits).
| Name | Type | Description |
|---|---|---|
filter | object | Filter appliedNull when every outstanding bill is listed. |
id | string | Filter id |
name | string | Filter name |
description | string | Filter description |
count | integer | Number of bills |
total | number | Total amount dueIn the base currency. |
baseCurrency | string | Base currency |
bills | object[] | Bills |
supplier | string | SupplierFor an expense claim, the employee and the claim. |
invoiceNumber | string | Invoice number |
type | string | Type one of |
date | string (date) | Date |
dueDate | string (date) | Due date |
scheduledDate | string (date) | Scheduled date |
tags | string | TagsComma-separated. |
currency | string | CurrencyThe bill's own currency. |
originalAmount | number | Original amountIn the bill's currency, when it is not the base currency. |
amountDue | number | Amount dueIn the base currency. |
latestNote | string | Latest note |
Example
curl -X GET 'https://api.syncedhq.com/v1/operations/bills.list_to_pay' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Try it
Try it
Sign in to send this request as yourself. You choose the organisations on Synced's consent screen; the token stays in this tab and expires within an hour.
A saved Bills to Pay filter, by name or words from its description. Leave empty for all bills.
curl -X GET 'https://api.syncedhq.com/v1/operations/bills.list_to_pay' \ -H 'Accept: application/json'
Sign in, then send the request.