# One provider account with its domains

> One provider account with its domains: CustomDomain™ API reference in the provider accounts group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/provider-accounts/getProviderAccount

## `GET https://api.customdomain.ai/v1/provider-accounts/{id}`

A viewer reads it without `agent_key.account` and `agent_key.session_id`.

For whoever manages the account (`can_manage`, and never a viewer), it also carries `more_domains`: the domains the key lists at the provider that the workspace has not connected, to offer them with `POST /provider-accounts/{id}/connect`. Listing them is a use of the key, so it is asked of the provider on this read (kept for a minute) and left out for anyone else, for a key an end user's secure sign-in made, and for an account with no usable key. The read changes nothing: a key the provider refuses, or a list that fails, leaves `more_domains` out and the account as it was.

### Authentication

`apiKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

### Responses

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

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | object | no |  |

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