# List service principals in the account

Launch stage: Beta

`GET /api/2.0/identity/service-principals`

Lists the service principals in the Databricks
 account that parents the calling workspace, returning one page per call. Supports filtering by
 application ID or external ID.

API scopes: identity

## Query parameters

- `page_size` (int32, optional)
  The maximum number of SPs to return. The service may return fewer than this value.
   If not provided, defaults to 1000, which is also the maximum allowed. Requests for more than the maximum are clamped to 1000.
- `page_token` (string, optional)
  A page token, received from a previous ListServicePrincipals call. Provide this to retrieve the subsequent page.
- `filter` (string, optional)
  Optional. Allows filtering service principals by application id or external id.

## Returns

Returns a list of ServicePrincipal objects.

## Response

```json
{
  "service_principals": [
    {
      "account_id": "string",
      "service_principal_id": "string",
      "external_id": "string",
      "application_id": "string",
      "display_name": "string",
      "account_sp_status": "ACTIVE"
    }
  ],
  "next_page_token": "string"
}
```