> 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/nl/docs/products/domain-lifecycle

# Domeinlevenscyclus API-referentie

Krijg gedetailleerde informatie over de levenscyclus van een domein, inclusief registratie, vervaldatum en statusgeschiedenis. Gebruik deze referentie om het juiste endpoint te kiezen en precies te zien wat het teruggeeft.

[Productpagina bekijken](https://domscan.net/nl/domain-lifecycle-api)

## Bewerkingen

GET `/v1/lifecycle` [API-referentie bekijken](https://domscan.net/nl/docs/products/domain-lifecycle#getDomainLifecycle)

## GET `/v1/lifecycle`

Bewerking: `getDomainLifecycle`
Credits en authenticatie: 2
Authenticatie vereist

GET /v1/lifecycle Tegoeden: 2

#### Queryparameters

| Parameter | Type | vereist |
| --- | --- | --- |
| domain | string | vereist |

#### Antwoordvelden

| Veld | 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 |

#### Voorbeeldverzoek

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

```javascript
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);
```

```python
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())
```

```go
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))
}
```

```ruby
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))
```

#### Voorbeeldantwoord

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

#### HTTP-statuscodes

- `200` OK
- `400` Ongeldig verzoek
- `401` Niet geautoriseerd
- `402` Betaling vereist
- `429` Te veel verzoeken
- `502` Gatewayfout
- `503` Service niet beschikbaar

## Referentiebronnen

[OpenAPI 3.0](https://domscan.net/v1/openapi.json)
[Postman](https://domscan.net/v1/postman.json)
[MCP](https://domscan.net/nl/mcp-domain-checker)
