API DescriptionSettingsFAQ
API Reference
Start typing to search…

List all categories

get
https://api.mercury.com/api/v1/categories

Retrieve a paginated list of all available custom expense categories for the organization. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.

Query Params
int64
1 to 1000
Defaults to 1000

Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000

string
enum
Defaults to asc

Sort order. Can be 'asc' or 'desc'. Defaults to 'asc'

Allowed:
uuid

The ID of the category to start the page after (exclusive). When provided, results will begin with the category immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.

uuid

The ID of the category to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.

Responses

400

Invalid end_before or start_after or order or limit

Updated 2 months ago

Language
Credentials
Bearer
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 2 months ago