API Reference

Esta página aún no está disponible en tu idioma.

Domains

Check availability

Check whether a domain name is currently available for registration.

GET /v1/domains/check

Query parameters

Parameter	Type	Required	Description
`domain`	string	✅	Fully qualified domain name, e.g. `example.com`

Example request

curl -G https://api.domchekr.com/v1/domains/check \
  -H "Authorization: Bearer $API_KEY" \
  --data-urlencode "domain=example.com"

const res = await fetch('https://api.domchekr.com/v1/domains/check?domain=example.com', {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
const data = await res.json();

import httpx

r = httpx.get(
    "https://api.domchekr.com/v1/domains/check",
    params={"domain": "example.com"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
data = r.json()

Response

{
  "domain": "example.com",
  "available": false,
  "status": "registered",
  "expires_at": "2026-01-15T00:00:00Z",
  "checked_at": "2025-03-11T12:34:56Z"
}

List watched domains

Return all domains in the authenticated account’s watchlist.

GET /v1/watchlist

Query parameters

Parameter	Type	Default	Description
`status`	string	—	Filter by status: `available`, `registered`, `expiring`, `pending_delete`
`page`	integer	`1`	Page number
`per_page`	integer	`20`	Results per page (max `100`)

Response

{
  "data": [
    {
      "id": "wl_01HX...",
      "domain": "mystore.io",
      "status": "registered",
      "interval_minutes": 60,
      "last_checked_at": "2025-03-11T12:00:00Z",
      "created_at": "2025-01-01T09:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1
  }
}

Add a domain to the watchlist

POST /v1/watchlist

Request body

{
  "domain": "mystore.io",
  "interval_minutes": 60
}

Field	Type	Required	Description
`domain`	string	✅	Domain name to monitor
`interval_minutes`	integer	❌	Check interval. Must match a value allowed by your plan.

Response — 201 Created

{
  "id": "wl_01HX...",
  "domain": "mystore.io",
  "status": "registered",
  "interval_minutes": 60,
  "created_at": "2025-03-11T13:00:00Z"
}

Remove a domain from the watchlist

DELETE /v1/watchlist/{id}

Response — 204 No Content

Notifications

List notification channels

GET /v1/notifications

Response

{
  "data": [
    { "id": "nc_abc", "type": "email", "target": "you@example.com", "active": true },
    { "id": "nc_def", "type": "webhook", "target": "https://hooks.example.com/domchekr", "active": true }
  ]
}

Add a notification channel

POST /v1/notifications

Request body

{
  "type": "webhook",
  "target": "https://hooks.example.com/domchekr"
}

Field	Allowed values
`type`	`email`, `webhook`
`target`	Email address or a valid HTTPS URL

Response — 201 Created