Domain Lifecycle API

What you get

Get detailed lifecycle information for a domain including registration, expiration, and status history.

SynchronousRESTMCPSDKInteractive tool

Choose this product when

Who it is for

Use focused checks for a single decision or assemble a broader profile when context matters.

Choose this product when

Choose this to interpret expiry timing, status flags, and lifecycle phase where records provide them.

What you get

Get detailed lifecycle information for a domain including registration, expiration, and status history.

Endpoints

Review the supported operations, inputs, outputs, execution modes, and response limits before integrating.

GET /v1/lifecycle View API reference

Credits and authentication

2 Authentication required. Check the operation reference for the exact cost and any per-item pricing.

Example operation

Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.

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

Limits and evidence boundaries

Results describe observed public evidence and its provenance.

Unknown means the requested fact could not be determined from the available evidence.

Cached indicates that stored evidence was used; review freshness metadata where provided.

Evidence can change over time; use timestamps and freshness fields when provided.

Reviewed 2026-08-22

Related products

Frequently asked questions

Where can I find the Domain Lifecycle request and response reference?

Use the API reference for Domain Lifecycle to review parameters, response fields, examples, status codes, and supported operation modes.

How should I interpret unknown or incomplete results from Domain Lifecycle?

Unknown or partial results mean that the requested evidence could not be fully determined. Keep the result state, confidence, freshness, and limitations in downstream decisions.

How is Domain Lifecycle priced?

Pricing depends on the operation and execution mode. Check the endpoint reference for the current credit cost, authentication requirement, and per-item rules.