---
title: "Retrieve a list of accounting categories"
method: GET
path: "/accounting-categories"
tags: ["Accounting", "Accounting categories"]
---

# Retrieve a list of accounting categories

`GET /accounting-categories`

## Request

- Base URL: `https://b2b.revolut.com/api/1.0`
- URL: `https://b2b.revolut.com/api/1.0/accounting-categories`
- Auth: HTTP bearer

Get available accounting categories based on the provided query criteria.

:::note
The API returns a maximum of 500 accounting categories per request. 
The default page size is 100.
:::

The accounting categories are sorted by the `created_at` date in reverse chronological order, and they're **paginated**.
The page size, that is, the maximum number of accounting categories returned per page is specified by the `limit` parameter. 
- If the number of results exceeds the page size, the response also returns a cursor for the next page under `next_page_token`.        
  To get the next page of results, make a new request using that `next_page_token` value in `page_token`.
- If the number of results is smaller than the page size, `next_page_token` is not returned.

For more details, see the guides: [Manage accounting settings](https://developer.revolut.com/docs/guides/manage-accounts/accounting/manage-accounting-settings) and [Manage accounting categories](https://developer.revolut.com/docs/guides/manage-accounts/accounting/manage-accounting-categories).

## Query parameters

- `limit` integer
- `page_token` string, byte: Cursor for the next page. Used for pagination when the total number of results exceeds the maximum number per page. To get the next page of results, make a new request and set `page_token` to the `next_page_token` value returned in the previous response. Omit this parameter to fetch the first page. :::note If there are no more results to fetch, `next_page_token` is not returned in the response. :::

## Response `200`

List of accounting categories and the next page token if the number of results exceeds the page size

- object
  - `next_page_token` string, byte: Cursor for the next page. Used for pagination when the total number of results exceeds the maximum number per page. To get the next page of results, make a new request and set `page_token` to the `next_page_token` value returned in the previous response. Omit this parameter to fetch the first page. :::note If there are no more results to fetch, `next_page_token` is not returned in the response. :::
  - `accounting_categories` AccountingCategoryResponse[], required: The list of accounting categories.
    - `id` string, uuid, required: The unique ID of the accounting category.
    - `name` string, required: The name of the accounting category.
    - `code` string: The code of the accounting category.
    - `created_at` string, date-time, required: The date and time the accounting category was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `updated_at` string, date-time, required: The date and time the accounting category was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `default_tax_rate_id` string, uuid: The ID of the default [tax rate](https://developer.revolut.com/docs/api/business#get-tax-rate) applied to items in this accounting category unless overridden for a specific item.

## Other responses

- `400`: Bad Request Returned, for example, when a required parameter is missing or malformatted.
- `401`: Unauthorized – authentication credentials are missing or invalid Returned when the request was not fulfilled because authentication has failed or has not been provided.
- `403`: Action forbidden - insufficient permissions to perform this action Returned, for example, when you don't have permissions necessary to perform this action.
- `429`: Too many requests Returned, for example, when the rate limit has been exceeded. If the response includes the `Retry-After` instruction, please respect it and refrain from earlier retry attempts.
- `500`: Internal server error An unexpected application error occurred.
- `503`: Service Unavailable The system is temporarily unavailable. If the response includes the `Retry-After` header instruction, please respect it and refrain from earlier retry attempts.
- `default`: Unexpected error

---

[API](https://skmtc.dev/revolut/apis/business-api.md) - [All operations](https://skmtc.dev/revolut/apis/business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/revolut/apis/business-api/revisions/be089d9fa8b4?raw)