---
updatedAt: 2026-04-20T19:21:55.000Z
---

# List API clients

Returns a list of API clients, optionally filtered by client feature. Only the `owner` client can run this operation.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Clients",
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://{hostname}"
    }
  ],
  "paths": {
    "/clients/list": {
      "get": {
        "operationId": "get-list",
        "summary": "List API clients",
        "description": "Returns a list of API clients, optionally filtered by client feature. Only the `owner` client can run this operation.",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "stat": "ok",
                  "results": [
                    {
                      "client_id": "12345abcde12345abcde",
                      "client_secret": "edcba54321edcba54321",
                      "description": "application owner",
                      "whitelist": [
                        "0.0.0.0/0"
                      ],
                      "features": [
                        "access_issuer",
                        "direct_access",
                        "owner"
                      ]
                    }
                  ]
                },
                "schema": {
                  "description": "Returns information about an application's API clients. API clients control access to the Identity Cloud APIs. For example, to access the Configuration API, you use an API client ID and client secret instead of using your username and password.\n",
                  "type": "object",
                  "properties": {
                    "whitelist": {
                      "type": "array",
                      "description": "CIDR blocks that can access the API client. The default value of `0.0.0.0/0` indicates that any IP address has access to the client.\n",
                      "items": {
                        "type": "string",
                        "description": "CIDR block able to access the API client\n"
                      },
                      "example": "0.0.0.0/0"
                    },
                    "features": {
                      "type": "array",
                      "description": "Specifies the features of the API client. Features determine the level of administrative access that API clients have to user records and application management functionality. For example, an `owner` client has access to all user records, while a `login_client` client can only access records for the currently authenticated user.\n",
                      "items": {
                        "type": "string",
                        "description": "Name of a feature that can be assigned to an API client. You can assign multiple features to a single client. However, if you assign the `login_client` feature that's the only feature that can be assigned to the client.\n",
                        "enum": [
                          "access_issuer",
                          "direct_access",
                          "owner",
                          "login_client",
                          "direct_read_access"
                        ]
                      }
                    },
                    "description": {
                      "type": "string",
                      "description": "Brief description of the API client, its properties, and its intended use.\n",
                      "example": "application owner"
                    },
                    "client_id": {
                      "type": "string",
                      "description": "Unique identifier of the API client.\n",
                      "example": "12345abcde12345abcde"
                    },
                    "client_secret": {
                      "type": "string",
                      "description": "Client secret of the API client. When running API operations, the client ID functions as the username and the client secret functions as the password.\n",
                      "example": "edcba54321edcba54321"
                    },
                    "stat": {
                      "type": "string",
                      "description": "Indicates the status of the current operation.\n",
                      "example": "ok"
                    }
                  }
                }
              }
            },
            "description": "Successful response\n"
          }
        },
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "properties": {
                  "has_features": {
                    "type": "array",
                    "description": "Filters for clients assigned a specific feature. Features determine the permissions granted to API clients. Configure your feature set as a JSON array. The operation returns any client assigned at least one of the features listed in the array.\n",
                    "items": {
                      "description": "Feature assigned to the client.\n",
                      "type": "string",
                      "enum": [
                        "owner",
                        "access_issuer",
                        "direct_read_access",
                        "direct_access"
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "curl",
      "python",
      "node"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "externalDocs": {
    "url": "https://techdocs.akamai.com/identity-cloud-legacy-clients/reference",
    "description": "See documention for Akamai's Identity Cloud: Legacy Clients and Settings API\n"
  }
}
```