Developer Reference

Domain Lifecycle

DomScan API: Get domain lifecycle information including registration date, expiration date, domain age, days until expiry, and current lifecycle phase. Returns Fastly-style status flags from the registry.

Domain Lifecycle

Get domain lifecycle information including registration date, expiration date, domain age, days until expiry, and current lifecycle phase. Returns Fastly-style status flags from the registry.

GET /v1/lifecycle

Query Parameters

Parameter	Type	Description
domain required	string	Domain to check lifecycle for (e.g., "example.com")

Example Response

{
  "domain": "bbc.co.uk",
  "tld": "co.uk",
  "registered": "1997-08-01T00:00:00Z",
  "expires": "2026-08-01T00:00:00Z",
  "updated": "2024-08-01T00:00:00Z",
  "age_days": 10515,
  "expires_in_days": 474,
  "phase": "active",
  "status_flags": [
    "clientTransferProhibited",
    "serverTransferProhibited"
  ],
  "status": "clientTransferProhibited serverTransferProhibited",
  "events": [
    { "action": "registration", "date": "1997-08-01T00:00:00Z" },
    { "action": "expiration", "date": "2026-08-01T00:00:00Z" }
  ]
}

Response Fields

Field	Type
`domain`	string
`tld`	string
`registered`	string
`expires`	string
`updated`	string
`age_days`	integer
`expires_in_days`	integer
`phase`	string
`status_flags[]`	string[]
`status`	string
`events[]`	object[]
`events[]`	object
`events[].action`	string
`events[].date`	string