# Whether the workspace may connect new domains

> Whether the workspace may connect new domains: CustomDomain™ API reference in the billing group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/billing/getBillingStanding

## `GET https://api.customdomain.ai/v1/billing/standing`

The lean read the MCP server's `check-billing-status` tool uses: whether a new connection is refused right now, and if so the same `code`, `title` and `details` the refusal carries (`billing_required`), plus the plan and its usage over the quota window (12 months on Starter, else this month). It has no dates, amounts, invoices or card; owners and admins read those from `GET /billing/status`. Any workspace credential may read it: a tenant API key of any role, a delegated agent token with `domains:read`, or a widget token minted with scope `app`. A `connect`-scoped widget token (an end user's) is refused with `403`.

### Authentication

`apiKey`, `widgetJWT`, `agentToken`

### Responses

| Status | Description |
| --- | --- |
| `200` | The workspace's standing |
| `401` | Error envelope: {code, title, details}. |
| `403` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `configured` | boolean | yes | Whether a workspace can subscribe on this deployment. |
| `restricted` | boolean | yes | New domain connections are refused right now. |
| `first_domain_free` | boolean | no | Present only when true: this is a new workspace on the first domain free rule. `restricted` is false until its free domains are connected, and true, with the refusal's words, after. |
| `free_domains` | integer | no | Present with `first_domain_free`: how many domains the workspace may connect before it has a subscription. One, unless the operator granted more. |
| `attention` | boolean | yes | Billing needs an owner or admin: a trial or grace to act on, a failed payment, or a block. |
| `code` | string | no | Set when `restricted`: `billing_required`. |
| `title` | string | no | Set when `restricted`: what the refusal says. |
| `details` | string | no | Set when `restricted`: why, and where an owner or admin fixes it. |
| `billing_url` | string | yes | Where an owner or admin sets up billing. |
| `plan` | object | no |  |
| `usage` | object | no |  |

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