API-referentie

Domeinwatchlist API-referentie

Beheer uw domeinwatchlist. Ontvang meldingen wanneer domeinen beschikbaar worden of van status veranderen. Gebruik deze referentie om een bewerking te kiezen en het gedocumenteerde responsecontract te integreren.

Bewerkingen

GET /v1/watchlist API-referentie bekijken
POST /v1/watchlist API-referentie bekijken
DELETE /v1/watchlist API-referentie bekijken
GET /v1/watchlist/expiring API-referentie bekijken
GET /v1/watchlist/available API-referentie bekijken

GET /v1/watchlist

Bewerking: getWatchlist Credits en authenticatie: 1 Authenticatie vereist
GET /v1/watchlist

Antwoordvelden

Veld Type
watchlist[] object[]
watchlist[] object
watchlist[].domain string
watchlist[].added_at string
watchlist[].status string
watchlist[].last_checked string
watchlist[].expiry_date string
watchlist[].days_until_expiry integer
watchlist[].notify_email string
total integer
updated_at string

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist"

Voorbeeldantwoord

{
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2024-01-01T00:00:00Z",
      "status": "registered",
      "last_checked": "2024-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "updated_at": "2024-01-15T12:00:00Z"
}

POST /v1/watchlist

Bewerking: addToWatchlist Credits en authenticatie: 1 Authenticatie vereist
POST /v1/watchlist

Lichaamsparameters

Parameter Type vereist
domain string vereist
notify_email string optioneel

Antwoordvelden

Veld Type
success boolean
message string
watchlist[] object[]
watchlist[] object
watchlist[].domain string
watchlist[].added_at string
watchlist[].status string
watchlist[].last_checked string
watchlist[].expiry_date string
watchlist[].days_until_expiry integer
watchlist[].notify_email string
total integer

Voorbeeldverzoek

curl -X POST "https://domscan.net/v1/watchlist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domain": "example.com",
  "notify_email": "[email protected]"
}'

Voorbeeldantwoord

{
  "success": true,
  "message": "string",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1
}

DELETE /v1/watchlist

Bewerking: removeFromWatchlist Credits en authenticatie: Gratis Authenticatie vereist
DELETE /v1/watchlist

Queryparameters

Parameter Type vereist
domain string vereist

Antwoordvelden

Veld Type
success boolean
message string
domain string

Voorbeeldverzoek

curl -X DELETE "https://domscan.net/v1/watchlist?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'

Voorbeeldantwoord

{
  "success": true,
  "message": "string",
  "domain": "example.com"
}

GET /v1/watchlist/expiring

Bewerking: getExpiringWatchlist Credits en authenticatie: 1 Authenticatie vereist
GET /v1/watchlist/expiring

Queryparameters

Parameter Type vereist
days integer
Standaard 90
optioneel

Antwoordvelden

Veld Type
expiring_domains[] object[]
expiring_domains[] object
expiring_domains[].domain string
expiring_domains[].added_at string
expiring_domains[].status string
expiring_domains[].last_checked string
expiring_domains[].expiry_date string
expiring_domains[].days_until_expiry integer
expiring_domains[].notify_email string
total integer
threshold_days integer

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/expiring?days=example.com"

Voorbeeldantwoord

{
  "expiring_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1,
  "threshold_days": 1
}

GET /v1/watchlist/available

Bewerking: getAvailableWatchlist Credits en authenticatie: 1 Authenticatie vereist
GET /v1/watchlist/available

Antwoordvelden

Veld Type
available_domains[] object[]
available_domains[] object
available_domains[].domain string
available_domains[].added_at string
available_domains[].status string
available_domains[].last_checked string
available_domains[].expiry_date string
available_domains[].days_until_expiry integer
available_domains[].notify_email string
total integer
message string

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/available"

Voorbeeldantwoord

{
  "available_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1,
  "message": "string"
}

Referentiebronnen