> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equalsmoney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List roles

> View a list of all the available roles.

## List all roles

<Note>
  **GET** `/v2/roles`
</Note>

### Request

Use this request to get a list of all roles that are currently supported.

<CodeGroup>
  ```bash Sample request theme={null}
  curl -i -X GET \
    'https://api.equalsmoney.com/v2/roles' \
    -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
  ```

  ```bash Request structure theme={null}
  curl -i -X GET \
    'https://api.equalsmoney.com/v2/roles' \
    -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
  ```
</CodeGroup>

#### Query parameters

<ParamField body="limit" type="integer">
  The maximum amount of results to return. By default, this is set to `100`.

  Allowable values: `[ 1 .. 1000 ]`
</ParamField>

<ParamField body="offset" type="integer">
  The amount of results to skip. By default, this is set to `0`.

  Allowable values: A valid integer
</ParamField>

### Response

If your request is successful, you'll receive a `200` response containing a list of roles.

<CodeGroup>
  ```json Sample response theme={null}
  {
    "limit": 100,
    "offset": 200,
    "count": 1,
    "rows": [
      {
        "accountId": "F12345",
        "id": "fbc32687-acbf-4a8b-b60e-b93bb75878ca",
        "name": "Owner",
        "type": "core"
      }
    ]
  }
  ```

  ```json Response structure theme={null}
  {
    "limit": integer,
    "offset": integer,
    "count": integer,
    "rows": [
      {
        "accountId": "string",
        "id": "string",
        "name": "string",
        "type": "string"
      }
    ]
  }
  ```
</CodeGroup>

For more detailed information about this request and its response, [see the API reference](/api-reference/people/list-roles).