---
title: "Retrieve a list of departments"
method: GET
path: "/departments"
tags: ["Teams"]
---

# Retrieve a list of departments

`GET /departments`

## Request

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

Get a paginated list of all departments in your business.

For more information, see the guides: [Manage departments](https://developer.revolut.com/docs/guides/manage-accounts/teams/manage-departments).

## Query parameters

- `limit` number
- `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`

A paginated list of departments.

- object
  - `departments` Department[], required
    - `id` string, uuid, required: The ID of the department.
    - `name` string, required: The name of the department.
    - `created_at` string, date-time, required: The date and time the department was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `updated_at` string, date-time, required: The date and time the department was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `next_page_token` string: Token to fetch the next page. Omitted when there are no more results.

## Other responses

- `400`: Bad pagination parameters Returned when the pagination parameters are invalid.
- `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.
- `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)