Domains

Create a domain

Track a domain for expiry and WHOIS changes. Registrar and expiry fields are populated automatically after the first check.

POSThttps://api.vantaj.co/v1/domains

Requires an API key with the domains:write scope.

Authorizations

Authorizationstringheaderrequired

Bearer authentication using your API key: Authorization: Bearer <token>

Body

application/json

project_idstring<uuid>required

Project the domain belongs to.

domainstringrequired

A bare hostname, e.g. example.com (no scheme or path).

alert_daysinteger[]

Days before expiry to alert on (1–365).

Create a domain

cURL

curl --request POST \
  --url 'https://api.vantaj.co/v1/domains' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "project_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "domain": "example.com",
  "alert_days": [
    30,
    7,
    1
  ]
}'

{
  "data": {
    "id": "b3d2c1a0-9f8e-7d6c-5b4a-3c2d1e0f9a8b",
    "domain": "example.com",
    "expires_at": "2027-03-01T00:00:00Z",
    "registered_at": "2010-03-01T00:00:00Z",
    "registrar_updated_at": "2026-02-15T00:00:00Z",
    "registrar": "MarkMonitor Inc.",
    "registrar_url": "https://markmonitor.com",
    "nameservers": [
      "ns1.example.com",
      "ns2.example.com"
    ],
    "statuses": [
      "clientTransferProhibited"
    ],
    "dnssec": false,
    "alert_days": [
      30,
      7,
      1
    ],
    "last_checked_at": "2026-06-21T06:00:00Z",
    "created_at": "2026-01-15T10:30:00Z"
  }
}