List Bills To Pay Filters

GET/v1/operations/bills.list_saved_filters

Lists the organisation's saved Bills to Pay filters: name, description, and how many outstanding bills each matches with their total amount due. Pass a name to bills_list_to_pay as its filter.

Scope: synced.read · reads only
Roles: Super admin, Admin, Submitter, Custom (by default; an admin can change this per operation)
MCP tool: bills_list_saved_filters

Request

Send the token as Authorization: Bearer. A token approved for several organisations also sends Synced-Organisation: {id} (see Organisations).

Query parameters

None.

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
`baseCurrency`	string	Base currency
`filters`	object[]
`id`	string	Filter id
`name`	string	Name
`description`	string	Description
`count`	integer	Number of bills
`total`	number	Total amount due

Example

curl -X GET 'https://api.syncedhq.com/v1/operations/bills.list_saved_filters' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

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.

This operation takes no inputs.

Request

curl -X GET 'https://api.syncedhq.com/v1/operations/bills.list_saved_filters' \
  -H 'Accept: application/json'

Response

Sign in, then send the request.