Domain Intelligence · DomScan product

Domain Lifecycle API

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

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

See what each endpoint accepts and returns, its modes and its limits before you integrate.

GET /v1/lifecycle View API reference

Credits and authentication

2 Authentication required. See the API reference for the exact cost, including any per-item pricing.

Example operation

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

GET /v1/lifecycle Credits: 2

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
availability_reason string
registry_message string
status_flags[] string[]
status string
events[] object[]
events[] object
events[].action string
events[].date string
meta object
meta.served_by string

Example request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/lifecycle?domain=bbc.co.uk"
const response = await fetch("https://domscan.net/v1/lifecycle?domain=bbc.co.uk", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/lifecycle?domain=bbc.co.uk",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/lifecycle?domain=bbc.co.uk", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/lifecycle?domain=bbc.co.uk")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

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

HTTP status codes

  • 200 OK
  • 400 Bad Request
  • 401 Unauthorized
  • 402 Payment Required
  • 429 Too Many Requests
  • 502 Bad Gateway
  • 503 Service Unavailable

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 means we could not fully confirm the result. Keep the status, confidence, freshness and any limits in mind when you act on it.

How is Domain Lifecycle priced?

The price depends on the check and the mode you choose. The API reference shows the current credit cost, whether you need an API key, and any per-item pricing.

Used by people at these companies

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse