List Authorizations

ListAuthorizations returns all authorizations matching the request and necessary permissions.

Note: Authorization in this context refers to role assignments, not to OAuth authorization.

Required permissions:

"user.grant.read"
no permissions required for listing own authorizations

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1

Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

pagination?|

Paginate through the results using a limit, offset and sorting.

sortingColumn?string

Value in

"AUTHORIZATION_FIELD_NAME_UNSPECIFIED" | "AUTHORIZATION_FIELD_NAME_CREATED_DATE" | "AUTHORIZATION_FIELD_NAME_CHANGED_DATE" | "AUTHORIZATION_FIELD_NAME_ID" | "AUTHORIZATION_FIELD_NAME_USER_ID" | "AUTHORIZATION_FIELD_NAME_PROJECT_ID" | "AUTHORIZATION_FIELD_NAME_ORGANIZATION_ID" | "AUTHORIZATION_FIELD_NAME_USER_ORGANIZATION_ID"

filters?array<||||||||||>

Define the criteria to query for.

Response Body

`application/json`

curl -X POST "https://loading/zitadel.authorization.v2.AuthorizationService/ListAuthorizations" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{}'

{
  "pagination": {
    "totalResult": 0,
    "appliedLimit": 0
  },
  "authorizations": [
    {
      "id": "string",
      "creationDate": "2023-01-15T01:30:15.01Z",
      "changeDate": "2023-01-15T01:30:15.01Z",
      "project": {
        "id": "string",
        "name": "string",
        "organizationId": "string"
      },
      "organization": {
        "id": "string",
        "name": "string"
      },
      "user": {
        "id": "string",
        "preferredLoginName": "string",
        "displayName": "string",
        "avatarUrl": "string",
        "organizationId": "string"
      },
      "state": "STATE_UNSPECIFIED",
      "roles": [
        {
          "key": "string",
          "displayName": "string",
          "group": "string"
        }
      ]
    }
  ]
}

{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}

Header Parameters

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`