# List applications

> List applications: reference page for this CustomDomain™ API operation in the applications group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/applications/listApplications

## `GET https://api.customdomain.ai/v1/applications`

With an API key: the caller's own tenant's apps. A **test mode** key lists only its own application, which is how a server learns which application a key belongs to. With the management key: `?tenant_id=` selects the tenant.

### Authentication

`apiKey`, `managementKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `tenant_id` | query | string | no | Required only when listing with the management key. |

### Responses

| Status | Description |
| --- | --- |
| `200` | Applications |
| `400` | Error envelope: {code, title, details}. |
| `401` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `applications` | array of object | yes |  |
| `count` | integer | yes |  |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.