---
title: "How many domains use each service, per application and workspace"
method: GET
path: "/services:summary"
tags: ["Connections"]
---

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

`GET /services:summary`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/services:summary`
- Auth: HTTP bearer

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.

## Query parameters

- `app_id` string

## Response `200`

The counts

- object
  - `catalog` object[], required
    - `id` string
    - `name` string
  - `workspace` object, required
    - `domains` integer
    - `services` object
    - `attention` object
  - `applications` object[], required
    - `application_id` string
    - `name` string
    - `domains` integer
    - `services` object
    - `attention` object
  - `needs_attention` object[], required: The domains behind the attention counts, by domain name: one item per service that needs someone, at most 50.
    - `connection_id` string, required
    - `application_id` string, required
    - `domain` string, required
    - `service` string, required: The service id, as in catalog.
    - `name` string, required
    - `detail` string, required: What needs doing, for people.
  - `truncated` boolean, required: True when the workspace has more domains than one summary counts (2000).

## Other responses

- `401`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)