# catalog_roles_retrieve

Retrieve roles matching query parameters. Supports filtering by name, id, and slug.

Endpoint: GET /api/catalog/roles/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `id` (integer)
    Role ID

  - `name` (string)
    Role name

  - `name__iexact` (string)
    Exact match for role name (case insensitive)

  - `page` (integer)
    Page number for pagination

  - `page_size` (integer)
    Number of items per page

  - `platform_key` (string)
    Platform key

  - `slug` (string)
    Role slug

  - `sort` (string)
    Field to sort results by

## Response 200 fields (application/json):

  - `id` (integer, required)

  - `name` (string,null, required)
    The display name of the role.

  - `slug` (string,null, required)
    An additional unique slug field.

  - `platform_key` (string)

  - `skills` (array, required)

  - `skills.name` (string,null, required)
    Display name

  - `skills.slug` (string,null, required)
    An additional unique slug field. (Optional)

  - `skills.data` (any,null, required)
    Metadata