BEbeyondidentity
Applications

List Applications for a Realm

Changed on

To list all applications for a realm, send a GET request to /v1/tenants/$TENANT_ID/realms/$REALM_ID/applications.

The response will contain at most 100 items and may contain a page token to query the remaining items. If page size is not specified, the response will contain 100 items. There is no defined ordering of the list of applications in the response. Note that the maximum and default page sizes are subject to change.

When paginating, the page size is maintained by the page token but may be overridden on subsequent requests. The skip is not maintained by the page token and must be specified on each subsequent request.

Page tokens expire after one week. Requests which specify an expired page token will result in undefined behavior.

get/v1/tenants/{tenant_id}/realms/{realm_id}/applications

Request

Path parameters

tenant_idstring required
Example:000176d94fd7b4d1

A unique identifier for a tenant.

realm_idstring required
Example:19a95130480dfa79

A unique identifier for a realm.

Query parameters

page_sizeinteger

Number of items returned per page. The response will include at most this many results but may include fewer. If this value is omitted, the response will return the default number of results allowed by the method.

page_tokenstring

Token to retrieve the subsequent page of the previous request. All other parameters to the list endpoint should match the original request that provided this token unless otherwise specified.

Response

The response will be a JSON object with keys for applications and total_size. applications will be set to an array of application objects, each of which contains the standard application attributes. total_size will be set to the total number of items matched by the list request. If there are more items to be returned by the requested query, the response will also contain a key called next_page_token.

total_sizeinteger required

Total number of results returned by the operation. This value may be larger than the number of resources returned, such as when returning a single page where multiple pages are available.

next_page_tokenstring

Token used to fetch the next set of results. If this field is omitted, there are no subsequent pages.

Example response

{
  "applications": [
    {
      "id": "38833c36-6f47-4992-9329-ea0a00915137",
      "realm_id": "caf2ff640497591a",
      "tenant_id": "00011f1183c67b69",
      "resource_server_id": "84db69f5-48a8-4c11-8cda-1bae3a73f07e",
      "authenticator_config_id": "73731b7f-eb76-4143-9b4b-81a720385f5a",
      "display_name": "Pet Application",
      "protocol_config": {
        "allowed_scopes": [
          "pets:read"
        ],
        "client_id": "AYYNcuOSpfqIf33JeegCzDIT",
        "client_secret": "wWD4mPzdsjms1LPekQSo0v9scOHLWy5wmMtKAR2JNhJPAKXv",
        "confidentiality": "confidential",
        "token_endpoint_auth_method": "client_secret_basic",
        "grant_type": [
          "authorization_code"
        ],
        "redirect_uris": [
          "https://auth.mypetapp.com/callback"
        ],
        "token_configuration": {
          "expires_after": 86400,
          "token_signing_algorithm": "RS256",
          "subject_field": "id"
        },
        "pkce": "s256",
        "token_format": "self_contained"
      }
    }
  ],
  "total_size": 1000
}

Changes

  • 42f3cac49392Revision changes
    • info

      added the optional property /////// to the response with the status