---
title: IAM Roles
summary: An identity and access management (IAM) role is a collection of permissions that define access to account resources.
url: https://www.fastly.com/documentation/reference/api/account/roles
---

An identity and access management (IAM) role is a collection of permissions that define access to account resources.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `limit` | integer | Maximum number of results returned. |
| `next_cursor` | string | Cursor for the next page. |
| `permissions` | array | The set of permissions granted to this role. |

## API endpoints

### List IAM roles

**GET** `/iam/v1/roles`

Retrieve a paginated list of IAM roles available in the account.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `cursor` | string | query | No | Cursor value from the <code>next_cursor</code> field of a previous response, used to retrieve the next page. To request the first page, this should be empty. |
| `limit` | integer | query | No | Number of results per page. The maximum is 1000. |

### Get IAM role by ID

**GET** `/iam/v1/roles/{role_id}`

Retrieve a single IAM role by its unique identifier.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `include` | string | query | No | Include related data (i.e., permissions). |
| `role_id` | string | path | Yes | Alphanumeric string identifying the role. |