# List custom domains

`GET https://app.clik.so/api/domains`

> **In short:** Returns your workspace's own custom domains, like `links.yourbrand.com`, with their verification status. Only verified ones can be used for links.

## 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" \
  -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"
    }
  ]
}
```

## Common errors

| Status | Code                  | When                                                                      |
| ------ | --------------------- | ------------------------------------------------------------------------- |
| 401    | `UNAUTHORIZED`        | The API key is missing, malformed or unknown.                             |
| 403    | `API_KEY_NOT_ALLOWED` | You sent a `POST`, `PUT` or `DELETE`. Domains are read-only for API keys. |
| 429    | `RATE_LIMITED`        | The key went over its per-minute request limit.                           |

## Good to know

* Use a domain for a link by sending its `id` as `custom_domain_id`. Only domains with `is_verified: true` work.
* This list does not include `clik.is` or Clikso's other free domains. Get those from [List free Clikso domains](https://clik.so/docs/api/domains/list-system-domains).
* API keys can only read domains. Adding, verifying and removing a domain happens in the dashboard.

---

Source: https://clik.so/docs/api/domains/list-domains