# Get a custom domain

`GET https://app.clik.so/api/domains/{id}`

> **In short:** Returns one of your workspace's custom domains by its id, with its verification status.

## You need

* **API key permission:** `read`
* **Workspace role:** viewer or higher
* **Plan:** any plan, including Free

## Example

```bash
curl "https://app.clik.so/api/domains/9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b" \
  -H "Authorization: Bearer $CLIKSO_API_KEY"
```

Response 200:

```json
{
  "status": 200,
  "success": true,
  "message": "Success",
  "data": {
    "id": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
    "workspace_id": "8a1f2c3d-4b5e-4f60-9a7b-1c2d3e4f5a6b",
    "domain_name": "links.example.com",
    "cloudflare_hostname_id": "0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "verification_details": null,
    "is_verified": true,
    "ssl_status": "active",
    "is_default": false,
    "created_at": "2026-10-02T10:00:00.000Z",
    "updated_at": "2026-10-02T10:20:00.000Z"
  }
}
```

## Parameters

| Name | In   | Type   | Required | Description             |
| ---- | ---- | ------ | -------- | ----------------------- |
| `id` | path | string | yes      | The custom domain's id. |

## Common errors

| Status | Code           | When                                                  |
| ------ | -------------- | ----------------------------------------------------- |
| 401    | `UNAUTHORIZED` | The API key is missing, malformed or unknown.         |
| 404    | `NOT_FOUND`    | No domain with this id exists in the key's workspace. |
| 429    | `RATE_LIMITED` | The key went over its per-minute request limit.       |

## Good to know

* API keys can only read domains. Verification and removal happen in the dashboard.

---

Source: https://clik.so/docs/api/domains/get-domain