# Get roles v2

Retrieve all roles for your environment.

Each role object includes the name, permissions, and other defining information.

Endpoint: GET /resources/roles/v2
Security: bearer

## Query parameters:

  - `_limit` (number)

  - `_sortBy` (string, required)
    Enum: "key", "name", "description", "isDefault", "firstUserRole", "level", "updatedAt", "createdAt", "permissions", "userTenants", "groups"

  - `_levels` (array)

  - `_tenantIds` (array)

  - `_offset` (number)
    The page number to retrieve. For example, use 0 for the first page, 1 for the second page.

  - `_order` (string)
    Enum: "ASC", "DESC"

  - `_filter` (string)

## Header parameters:

  - `frontegg-tenant-id` (string)
    For relating a role to a specific account (tenant), use get accounts (tenants) API to find the account (tenant) Ids

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string, required)

  - `items.vendorId` (string, required)

  - `items.tenantId` (string, required)

  - `items.key` (string, required)

  - `items.name` (string, required)

  - `items.description` (string, required)

  - `items.isDefault` (boolean, required)

  - `items.firstUserRole` (boolean, required)

  - `items.level` (number, required)

  - `items.createdAt` (string, required)

  - `items.updatedAt` (string, required)

  - `items.permissions` (array, required)

  - `_links` (object)

  - `_links.next` (string, required)

  - `_links.prev` (string, required)

  - `_links.first` (string, required)

  - `_links.last` (string, required)

  - `_metadata` (object)

  - `_metadata.totalItems` (number, required)

  - `_metadata.totalPages` (number, required)