API quickstart

The DomainCare REST API lets you list domains, read events, query check results, and manage domains programmatically. All paid plans include API access.

Prerequisites

• A DomainCare account on a paid plan (API access is not available during the free trial).
• At least one domain added to your account.

1. Create an API key

1. Go to Settings > API Keys in the DomainCare dashboard.
2. Click Create API key.
3. Give the key a name (e.g. CI pipeline) and choose an expiry.
4. Copy the key immediately — it is shown only once.

The key format is dc_ followed by 32 hex characters.

2. Make your first request

Use the key as a Bearer token in the Authorization header:

curl https://domaincare.io/api/v1/domains \
  -H "Authorization: Bearer dc_your_key_here"

A successful response returns a paginated list of your active domains:

{
  "data": [
    {
      "id": "a1b2c3d4-...",
      "name": "example.com",
      "status": "active",
      "createdAt": "2026-01-15T10:30:00.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 }
}

3. Get a single domain

Use the domain id from the list response to fetch full details:

curl https://domaincare.io/api/v1/domains/a1b2c3d4-... \
  -H "Authorization: Bearer dc_your_key_here"

Returns the domain object:

{
  "data": {
    "id": "a1b2c3d4-...",
    "name": "example.com",
    "inputName": "example.com",
    "status": "active",
    "cmsDetected": null,
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-15T10:30:00.000Z"
  }
}

Returns 404 if the domain does not exist or belongs to a different account.

4. Check rate-limit headers

Every response includes rate-limit headers:

Next steps

• Authentication — key management, scoping, and error codes.
• API reference — interactive reference for every endpoint.