Developer reference
Domain Lifecycle
DomScan API: Get domain lifecycle information including registration date, expiration date, domain age, days until expiry, and current lifecycle phase.
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 |
meta |
object |
meta.served_by |
string |