---
api: 'Business API'
---

# Retrieve team roles

Get the list of roles for 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](/docs/guides/manage-accounts/teams/manage-team-members).

## Endpoint

GET `/roles`

## Parameters

### query parameters

- `created_before` (string, optional)
  Retrieves roles with `created_at` < `created_before`.
  The default value is the current date and time at which you are calling the endpoint.
  
  Provided in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

- `limit` (number, optional)
  The maximum number of roles returned per page.
  
  To get to the next page, make a new request and use the `created_at` date of the last role returned in the previous response as the value for `created_before`.

## Returns

### 200

Information about roles of the business

#### Response attributes


## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad pagination parameters |
| 401 | Unauthorized  Returned when the request was not fulfilled because authentication has failed or has not been provided |
| 403 | Action forbidden  Returned, for example, when you don't have permissions necessary to retrieve roles |