Categories

List all categories

Changed on

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.

get/categories

Request

  • Base URL
    https://api.mercury.com/api/v1
  • URL
    https://api.mercury.com/api/v1/categories
  • Auth
    • HTTP bearer
    • or HTTP basic

Query parameters

limitinteger

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

order'asc' | 'desc'

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

start_afterstring 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.

end_beforestring 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.

Changes

  • ab652aa5aa8eRevision changes
    • breaking

      the response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      media type application/json was changed to application/json;charset=utf-8 for the response status

    • info

      added to the response property allOf list for the response status

    • info

      removed subschema #2 from the // response property allOf list for the response status

  • 3e266f593eb1Revision changes
    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status