# List role assignments

Retrieves the information of the role assignments

Endpoint: GET /v1/role-assignments
Version: 1.0
Security: x-api-key

## Header parameters:

  - `Harness-Account` (string)
    Identifier field of the account the resource is scoped to. This is required for Authorization methods other than the x-api-key header. If you are using the x-api-key header, this can be skipped.

## Query parameters:

  - `page` (integer)
    Pagination page number strategy: Specify the page number within the paginated collection related to the number of items on each page.

  - `limit` (integer)
    Pagination: Number of items to return.

  - `sort` (string)
    Parameter on the basis of which sorting is done.
    Enum: "identifier", "name", "created", "updated"

  - `order` (string)
    Order on the basis of which sorting is done.
    Enum: "ASC", "DESC"

## Response 200 fields (application/json):

  - `role-assignment` (object)
    Role assignment request model

  - `role-assignment.identifier` (string, required)
    Role assignment identifier

  - `role-assignment.resource_group` (string, required)
    Resource group name

  - `role-assignment.role` (string, required)
    Role identifier

  - `role-assignment.roleReference` (object)
    Role referenced in role assignment

  - `role-assignment.roleReference.scope_level` (string, required)
    Role scope level

  - `role-assignment.roleReference.identifier` (string, required)
    Role identifier

  - `role-assignment.principal` (object, required)
    Role assignment principal

  - `role-assignment.principal.scope_level` (string)
    Principal scope level

  - `role-assignment.principal.identifier` (string, required)
    Principal identifier

  - `role-assignment.principal.type` (string, required)
    Principal type
    Enum: "USER", "USER_GROUP", "SERVICE_ACCOUNT"

  - `role-assignment.disabled` (boolean)
    Role assignment is disabled or not

  - `role-assignment.managed` (boolean)
    Role assignment is managed or not

  - `created` (integer)
    Creation timestamp for Role.

  - `updated` (integer)
    Last modification timestamp for Role.

  - `harness_managed` (boolean)
    Is harness managed