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

# Retrieve a list of team members

`GET /team-members`

## Request

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

Get information about all the team members of your business.

The results are paginated and sorted by the `created_at` date in reverse chronological order.

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

## Query parameters

- `created_before` string, date-time
- `limit` number

## Response `200`

Information about team members of the business

- TeamMember[]
  - `id` string, uuid, required: The ID of the team member.
  - `email` string, email, required: The email of the team member.
  - `first_name` string: The team member's first name.
  - `last_name` string: The team member's last name.
  - `state` 'created' | 'confirmed' | 'waiting' | 'active' | 'locked' | 'disabled', required: The state that the team member is in.
  - `role_id` string, required: The ID of the team member's [role](https://developer.revolut.com/docs/api/business#get-roles). This can be a UUID or other default role such as `Owner`.
  - `created_at` string, date-time, required: The date and time the team member was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `updated_at` string, date-time, required: The date and time the team member was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `department_id` string, uuid: The ID of the [department](https://developer.revolut.com/docs/api/business#get-departments) the team member is assigned to.
  - `manager_id` string, uuid: The ID of the team member's manager.

## Other responses

- `400`: Bad pagination parameters
- `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)