Domains

Update a domain

Update the expiry alert thresholds for a domain.

PATCHhttps://api.vantaj.co/v1/domains/{id}

Requires an API key with the domains:write scope.

Authorizations

Authorizationstringheaderrequired

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

Path parameters

idstring<uuid>required

The domain ID.

Body

application/json

alert_daysinteger[]required

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

Update a domain

cURL

curl --request PATCH \
  --url 'https://api.vantaj.co/v1/domains/<id>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "alert_days": [
    60,
    30,
    7
  ]
}'

{
  "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"
  }
}