Accounting
Labels

Retrieve a list of labels from a label group

Get labels from a specific label group based on the provided query criteria.

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

The labels are sorted by the created_at date in reverse chronological order, and they're paginated. The page size, that is, the maximum number of labels 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 and Manage labels and label groups.

get/label-groups/{group_id}/labels

Request

  • Base URL
    https://b2b.revolut.com/api/1.0
  • Auth
    HTTP bearer

Path parameters

group_idstring uuid required
Example:09ad1ad3-a1c0-4c09-b8f8-24b439e72690

The ID of the label group from which to retrieve labels.

Query parameters

limitinteger
Example:10

The page size, that is, the maximum number of labels to return per page.

To get the next page of results, use page_token.

page_tokenstring 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. :::

Example:MjAyNi0wMS0wMVQwOToxMzoxNS40MDZaN2RhNTFjZGY0LTZiYjctNDRkNi04OWU1LTc2OWEzZGYxZDc5ZA

Response

List of labels

next_page_tokenstring 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. :::

Example response

{
  "next_page_token": "MjAyNi0wMS0wMVQwOToxMzoxNS40MDZaN2RhNTFjZGY0LTZiYjctNDRkNi04OWU1LTc2OWEzZGYxZDc5ZA"
}

Changes

No recorded changes to this operation across all 1 revision of this API.