EN English ES Español DE Deutsch FR Français PT Português JP 日本語 CN 中文 AR العربية IT Italiano KR 한국어 RU Русский NL Nederlands TR Türkçe PL Polski SE Svenska
API reference

Domain Watchlist API

Manage your domain watchlist. Get notified when domains become available or change status. Use this reference to choose an operation and integrate its documented response contract.

View product page

Operations

GET /v1/watchlist View API reference
POST /v1/watchlist View API reference
DELETE /v1/watchlist View API reference
GET /v1/watchlist/expiring View API reference
GET /v1/watchlist/available View API reference

GET /v1/watchlist

Operation: getWatchlist Credits and authentication: 1 Authentication required
GET /v1/watchlist

Response Fields

Field 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

Example Request

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

Example Response

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

Operation: addToWatchlist Credits and authentication: 1 Authentication required
POST /v1/watchlist

Body Parameters

Parameter Type required
domain string required
notify_email string optional

Response Fields

Field 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

Example Request

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

Example Response

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

Operation: removeFromWatchlist Credits and authentication: Free Authentication required
DELETE /v1/watchlist

Query Parameters

Parameter Type required
domain string required

Response Fields

Field Type
success boolean
message string
domain string

Example Request

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

Example Response

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

GET /v1/watchlist/expiring

Operation: getExpiringWatchlist Credits and authentication: 1 Authentication required
GET /v1/watchlist/expiring

Query Parameters

Parameter Type required
days integer
Default 90
optional

Response Fields

Field 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

Example Request

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

Example Response

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

Operation: getAvailableWatchlist Credits and authentication: 1 Authentication required
GET /v1/watchlist/available

Response Fields

Field 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

Example Request

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

Example Response

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

Reference resources

OpenAPI 3.0 Postman MCP