Who it is for
Use focused checks for a single decision or assemble a broader profile when context matters.
Try a product, outcome, endpoint path, or API topic.
Get detailed lifecycle information for a domain including registration, expiration, and status history.
Get detailed lifecycle information for a domain including registration, expiration, and status history.
Use focused checks for a single decision or assemble a broader profile when context matters.
Choose this to interpret expiry timing, status flags, and lifecycle phase where records provide them.
Get detailed lifecycle information for a domain including registration, expiration, and status history.
See what each endpoint accepts and returns, its modes and its limits before you integrate.
2 Authentication required. See the API reference for the exact cost, including any per-item pricing.
Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.
| Parameter | Type | required |
|---|---|---|
| domain | string | required |
| 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 |
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)){
"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"
}
]
}
200 OK400 Bad Request401 Unauthorized402 Payment Required429 Too Many Requests502 Bad Gateway503 Service UnavailableUse the API reference for Domain Lifecycle to review parameters, response fields, examples, status codes, and supported operation modes.
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.
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