API reference

Domain Lifecycle API

Get detailed lifecycle information for a domain including registration, expiration, and status history. Use this reference to choose an operation and integrate its documented response contract.

View product page

Operations

GET /v1/lifecycle View API reference

GET `/v1/lifecycle`

Operation: getDomainLifecycle Credits and authentication: 2 Authentication required

GET /v1/lifecycle

Query Parameters

Parameter	Type	required
domain	string	required

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

Example Request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/lifecycle?domain=bbc.co.uk"

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": "last changed",
      "date": "2024-08-01T00:00:00Z"
    },
    {
      "action": "expiration",
      "date": "2026-08-01T00:00:00Z"
    }
  ]
}

Reference resources

OpenAPI 3.0 Postman MCP