> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/docs/lifecycle

# Domain Lifecycle

DomScan API: Get domain lifecycle information including registration date, expiration date, domain age, days until expiry, and current lifecycle phase.

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

```json
{
  "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 |