API reference

TLD Coverage API

Get the list of supported TLDs and RDAP endpoint health. Use this reference to choose an operation and integrate its documented response contract.

View product page

Operations

GET /v1/coverage View API reference

GET `/v1/coverage`

Operation: getCoverage Credits and authentication: Free Authentication optional

GET /v1/coverage

Query Parameters

Parameter	Type	required
live	string Allowed values `1`	optional

Response Fields

Field	Type
`gtlds[]`	string[]
`cctlds[]`	string[]
`total_tlds`	integer
`all_tlds[]`	string[]
`rdap_health[]`	object[]
`rdap_health[]`	object
`rdap_health[].tld`	string
`rdap_health[].endpoint`	string
`rdap_health[].ok`	boolean
`rdap_health[].p50_ms`	number
`rdap_health[].error_rate`	number
`bootstrap_source`	string
`bootstrap_last_updated`	string
`meta`	object
`meta.served_by`	string
`meta.bootstrap_ttl_s`	integer
`meta.live`	boolean

Example Request

curl "https://domscan.net/v1/coverage?live=example.com"

Example Response

{
  "gtlds": [
    "string"
  ],
  "cctlds": [
    "string"
  ],
  "total_tlds": 1,
  "all_tlds": [
    "string"
  ],
  "rdap_health": [
    {
      "tld": "com",
      "endpoint": "https://example.com",
      "ok": true,
      "p50_ms": 1,
      "error_rate": 1
    }
  ],
  "bootstrap_source": "iana",
  "bootstrap_last_updated": "2026-04-15T12:00:00Z",
  "meta": {
    "served_by": "string",
    "bootstrap_ttl_s": 1,
    "live": true
  }
}

Reference resources

OpenAPI 3.0 Postman MCP