# How many domains use each service, per application and workspace

> How many domains use each service, per application and workspace: CustomDomain™ API reference. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/connections/getServicesSummary

## `GET https://api.customdomain.ai/v1/services:summary`

For the API key's workspace (or one application with `app_id`), the number of domains using each service, and the number needing attention, in total and per application, and which domains need attention and why.

### Authentication

`apiKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `app_id` | query | string | no |  |

### Responses

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

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `catalog` | array of object | yes |  |
| `workspace` | object | yes |  |
| `applications` | array of object | yes |  |
| `needs_attention` | array of object | yes | The domains behind the attention counts, by domain name: one item per service that needs someone, at most 50. |
| `truncated` | boolean | yes | True when the workspace has more domains than one summary counts (2000). |

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