Parsed Domain RDAP API¶
Introduction¶
The Parsed Domain RDAP API returns the most recent Domain-RDAP registration record in response to a HTTP GET query. This API compliments the Parsed Whois API as some registries and registrar are beginning to support RDAP as an alternative to Whois for providing domain registration data.
Similar to the Parsed Whois API, the Parsed Domain RDAP API provides both parsed field data as well as the original unparsed RDAP record(s) for a domain.
Blended RDAP Records¶
Domain RDAP records for a given domain may be provided by a domain registry, registrar, or both. Domain registries maintain authoritative information about one or more top-level domains (e.g., .com), while domain registrars manage apex domains (e.g., domaintools.com). When domain information is present from both the registry and registrar, this API presents a blended record containing both sets of results as well the original raw JSON record from both the registry and registrar.
Authentication¶
The Parsed Domain-RDAP API supports Hash-Based Message Authentication Codes (HMAC) and open key authentication.
HMAC¶
Parameters¶
| Required Parameter | Value |
|---|---|
api_username |
Your API username |
timestamp |
Current timestamp, in ISO 8601 format, e.g.: 2024-07-01T14:37:59-0800 2024-07-01T22:37:59Z 2024-07-02T10:37:59+1200 |
signature |
HMAC signature of your request, using the MD5, SHA1, or SHA256 hashing algorithm |
Example¶
https://api.domaintools.com/v1/domaintools.com/rdap/parsed/?api_username={YOUR_USERNAME}&signature={SIGNATURE_VALUE}×tamp={TIMESTAMP_VALUE}
Open Key¶
Parameters¶
| Required Parameter | Value |
|---|---|
api_username |
Your API username |
api_key |
Your API key |
Example¶
https://api.domaintools.com/v1/domaintools.com/rdap/parsed/?api_username=YOUR_USERNAME&api_key=YOUR_API_KEY
Replace YOUR_USERNAME and YOUR_API_KEY from the URL above.
Base URL¶
https://api.domaintools.com/v1/
Endpoint¶
GET /{domain}/rdap/parsed
Path Parameter¶
Specify your queried domain in the endpoint path:
| Parameter | Type | Description |
|---|---|---|
| Domain | string | The domain name to query (e.g., example.com). |
Request Example¶
https://api.domaintools.com/v1/example.com/rdap/parsed/?api_username=YOUR_USERNAME&api_key=YOUR_API_KEY
Response Contents¶
Raw and Parsed Records for Registry and/or Registrar¶
Each response begins with either the raw registrar record, the raw registry record, or when useful information is present in both records, the response will contain both the registrar and registry record.
In this example, example.com contains only a registry record:
{
"response": {
"domain_rdap": [
{
"source": "registry",
"timestamp": "2024-10-16T08:20:54Z",
"link": "https://rdap.verisign.com/com/v1/domain/example.com",
"record": "{RAW REGISTRY RECORD}"
}
],
"parsed_domain_rdap": {PARSED RECORD}
}
}
In contrast, domaintools.com contains both a registry and a registrar record:
{
"response": {
"domain_rdap": [
{
"source": "registry",
"timestamp": "2024-10-16T00:00:55Z",
"link": "https://rdap.verisign.com/com/v1/domain/domaintools.com",
"record": "{RAW REGISTRY RECORD}"
},
{
"source": "registrar",
"timestamp": "2024-10-16T00:01:07Z",
"link": "https://enom.rdap.tucows.com/domain/DOMAINTOOLS.COM",
"record": "{RAW REGISTRAR RECORD}"
}
],
"parsed_domain_rdap": {PARSED RECORD},
"record_source": "domaintools.com"
}
}
Full Response Example¶
The following full response for espn.com consists of registry and registrar records.
{
"response": {
"domain_rdap": [
{
"source": "registry",
"timestamp": "2024-10-14T17:05:43Z",
"link": "https://rdap.verisign.com/com/v1/domain/espn.com",
"record": "{\"objectClassName\":\"domain\",\"handle\":\"1925816_DOMAIN_COM-VRSN\",\"ldhName\":\"ESPN.COM\",\"links\":[{\"value\":\"https:\\/\\/rdap.verisign.com\\/com\\/v1\\/domain\\/ESPN.COM\",\"rel\":\"self\",\"href\":\"https:\\/\\/rdap.verisign.com\\/com\\/v1\\/domain\\/ESPN.COM\",\"type\":\"application\\/rdap+json\"},{\"value\":\"https:\\/\\/apis.cscglobal.com\\/dbs\\/rdap-api\\/v1\\/domain\\/ESPN.COM\",\"rel\":\"related\",\"href\":\"https:\\/\\/apis.cscglobal.com\\/dbs\\/rdap-api\\/v1\\/domain\\/ESPN.COM\",\"type\":\"application\\/rdap+json\"}],\"status\":[\"client transfer prohibited\",\"server delete prohibited\",\"server transfer prohibited\",\"server update prohibited\"],\"entities\":[{\"objectClassName\":\"entity\",\"handle\":\"299\",\"roles\":[\"registrar\"],\"publicIds\":[{\"type\":\"IANA Registrar ID\",\"identifier\":\"299\"}],\"vcardArray\":[\"vcard\",[[\"version\",{},\"text\",\"4.0\"],[\"fn\",{},\"text\",\"CSC Corporate Domains, Inc.\"]]],\"entities\":[{\"objectClassName\":\"entity\",\"roles\":[\"abuse\"],\"vcardArray\":[\"vcard\",[[\"version\",{},\"text\",\"4.0\"],[\"fn\",{},\"text\",\"\"],[\"tel\",{\"type\":\"voice\"},\"uri\",\"tel:8887802723\"],[\"email\",{},\"text\",\"domainabuse@cscglobal.com\"]]]}]}],\"events\":[{\"eventAction\":\"registration\",\"eventDate\":\"1994-10-04T04:00:00Z\"},{\"eventAction\":\"expiration\",\"eventDate\":\"2025-10-03T04:00:00Z\"},{\"eventAction\":\"last changed\",\"eventDate\":\"2024-08-28T15:12:11Z\"},{\"eventAction\":\"last update of RDAP database\",\"eventDate\":\"2024-10-14T17:05:35Z\"}],\"secureDNS\":{\"delegationSigned\":false},\"nameservers\":[{\"objectClassName\":\"nameserver\",\"ldhName\":\"NS-1045.AWSDNS-02.ORG\"},{\"objectClassName\":\"nameserver\",\"ldhName\":\"NS-122.AWSDNS-15.COM\"},{\"objectClassName\":\"nameserver\",\"ldhName\":\"NS-1936.AWSDNS-50.CO.UK\"},{\"objectClassName\":\"nameserver\",\"ldhName\":\"NS-846.AWSDNS-41.NET\"}],\"rdapConformance\":[\"rdap_level_0\",\"icann_rdap_technical_implementation_guide_0\",\"icann_rdap_response_profile_0\"],\"notices\":[{\"title\":\"Terms of Use\",\"description\":[\"Service subject to Terms of Use.\"],\"links\":[{\"href\":\"https:\\/\\/www.verisign.com\\/domain-names\\/registration-data-access-protocol\\/terms-service\\/index.xhtml\",\"type\":\"text\\/html\"}]},{\"title\":\"Status Codes\",\"description\":[\"For more information on domain status codes, please visit https:\\/\\/icann.org\\/epp\"],\"links\":[{\"href\":\"https:\\/\\/icann.org\\/epp\",\"type\":\"text\\/html\"}]},{\"title\":\"RDDS Inaccuracy Complaint Form\",\"description\":[\"URL of the ICANN RDDS Inaccuracy Complaint Form: https:\\/\\/icann.org\\/wicf\"],\"links\":[{\"href\":\"https:\\/\\/icann.org\\/wicf\",\"type\":\"text\\/html\"}]}]}"
},
{
"source": "registrar",
"timestamp": "2024-10-14T17:05:45Z",
"link": "https://apis.cscglobal.com/dbs/rdap-api/v1/domain/ESPN.COM",
"record": "{\"rdapConformance\":[\"rdap_level_0\",\"icann_rdap_technical_implementation_guide_0\",\"icann_rdap_response_profile_0\"],\"objectClassName\":\"domain\",\"handle\":\"1925816_DOMAIN_COM-VRSN\",\"ldhName\":\"espn.com\",\"secureDNS\":{\"delegationSigned\":false},\"notices\":[{\"title\":\"Terms of Use\",\"description\":[\"Service subject to Terms of Use.\"],\"links\":[{\"value\":\"https://apis.cscglobal.com/dbs/rdap-api/v1/domain/espn.com\",\"rel\":\"self\",\"href\":\"https://apis.cscglobal.com/dbs/rdap-api/v1/domain/espn.com\",\"type\":\"text/html\"}]},{\"title\":\"Status Codes\",\"description\":[\"For more information on domain status codes, please visit https://icann.org/epp.\"],\"links\":[{\"value\":\"https://apis.cscglobal.com/dbs/rdap-api/v1/domain/espn.com\",\"rel\":\"glossary\",\"href\":\"https://icann.org/epp\",\"type\":\"text/html\"}]},{\"title\":\"RDDS Inaccuracy Complaint Form\",\"description\":[\"URL of the ICANN RDDS Inaccuracy Complaint Form: https://icann.org/wicf.\"],\"links\":[{\"value\":\"https://apis.cscglobal.com/dbs/rdap-api/v1/domain/espn.com\",\"rel\":\"help\",\"href\":\"https://icann.org/wicf\",\"type\":\"text/html\"}]}],\"nameservers\":[{\"objectClassName\":\"nameserver\",\"ldhName\":\"ns-846.awsdns-41.net\"},{\"objectClassName\":\"nameserver\",\"ldhName\":\"ns-1045.awsdns-02.org\"},{\"objectClassName\":\"nameserver\",\"ldhName\":\"ns-1936.awsdns-50.co.uk\"},{\"objectClassName\":\"nameserver\",\"ldhName\":\"ns-122.awsdns-15.com\"}],\"entities\":[{\"objectClassName\":\"entity\",\"handle\":\"299\",\"roles\":[\"registrar\"],\"publicIds\":[{\"type\":\"IANA Registrar ID\",\"identifier\":\"299\"}],\"vcardArray\":[\"vcard\",[[\"version\",{},\"text\",\"4.0\"],[\"fn\",{},\"text\",\"CSC Corporate Domains, Inc.\"],[\"adr\",{\"cc\":\"US\"},\"text\",[\"\",\"\",\"251 Little Falls Drive\",\"Wilmington\",\"DE\",\"19808\",\"\"]],[\"email\",{},\"text\",\"admin@internationaladmin.com\"],[\"tel\",{\"type\":\"voice\"},\"uri\",\"tel:+1.3026365400\"],[\"tel\",{\"type\":\"fax\"},\"uri\",\"tel:+1.3026365400\"]]],\"entities\":[{\"objectClassName\":\"entity\",\"roles\":[\"abuse\"],\"vcardArray\":[\"vcard\",[[\"version\",{},\"text\",\"4.0\"],[\"fn\",{},\"text\",\"Abuse Contact\"],[\"email\",{},\"text\",\"domainabuse@cscglobal.com\"],[\"tel\",{\"type\":\"voice\"},\"uri\",\"tel:+1.8887802723\"]]]}]},{\"objectClassName\":\"entity\",\"roles\":[\"administrative\"],\"vcardArray\":[\"vcard\",[[\"version\",{},\"text\",\"4.0\"],[\"fn\",{},\"text\",\"ESPN, Inc.\"],[\"org\",{},\"text\",\"ESPN, Inc.\"],[\"adr\",{\"cc\":\"US\"},\"text\",[\"\",\"\",\"935 Middle Street\",\"Bristol\",\"CT\",\"06010-1001\",\"\"]],[\"email\",{},\"text\",\"domreg@espn.com\"],[\"tel\",{\"type\":\"voice\"},\"uri\",\"tel:+1.8607662000\"],[\"tel\",{\"type\":\"fax\"},\"uri\",\"tel:+1.8607664502\"]]]},{\"objectClassName\":\"entity\",\"roles\":[\"technical\"],\"vcardArray\":[\"vcard\",[[\"version\",{},\"text\",\"4.0\"],[\"fn\",{},\"text\",\"ESPN, Inc.\"],[\"org\",{},\"text\",\"ESPN, Inc.\"],[\"adr\",{\"cc\":\"US\"},\"text\",[\"\",\"\",\"935 Middle Street\",\"Bristol\",\"CT\",\"06010-1001\",\"\"]],[\"email\",{},\"text\",\"domreg@espn.com\"],[\"tel\",{\"type\":\"voice\"},\"uri\",\"tel:+1.8607662000\"],[\"tel\",{\"type\":\"fax\"},\"uri\",\"tel:+1.8607664502\"]]]},{\"objectClassName\":\"entity\",\"roles\":[\"registrant\"],\"vcardArray\":[\"vcard\",[[\"version\",{},\"text\",\"4.0\"],[\"fn\",{},\"text\",\"ESPN, Inc.\"],[\"org\",{},\"text\",\"ESPN, Inc.\"],[\"adr\",{\"cc\":\"US\"},\"text\",[\"\",\"\",\"935 Middle Street\",\"Bristol\",\"CT\",\"06010-1001\",\"\"]],[\"email\",{},\"text\",\"domreg@espn.com\"],[\"tel\",{\"type\":\"voice\"},\"uri\",\"tel:+1.8607662000\"],[\"tel\",{\"type\":\"fax\"},\"uri\",\"tel:+1.8607664502\"]]]}],\"events\":[{\"eventAction\":\"registration\",\"eventDate\":\"1994-10-04T00:00:00Z\"},{\"eventAction\":\"expiration\",\"eventDate\":\"2025-10-03T04:00:00Z\"},{\"eventAction\":\"last update of RDAP database\",\"eventDate\":\"2024-10-14T12:55:47Z\"}],\"status\":[\"server delete prohibited\",\"server update prohibited\",\"server transfer prohibited\",\"client transfer prohibited\"]}"
}
],
"parsed_domain_rdap": {
"domain": "espn.com",
"handle": "1925816_DOMAIN_COM-VRSN",
"domain_statuses": [
"server delete prohibited",
"server update prohibited",
"server transfer prohibited",
"client transfer prohibited"
],
"creation_date": "1994-10-04T00:00:00+00:00",
"last_changed_date": "2024-08-28T15:12:11+00:00",
"expiration_date": "2025-10-03T04:00:00+00:00",
"registrar": {
"name": "CSC Corporate Domains, Inc.",
"iana_id": "299",
"contacts": [
{
"handle": null,
"name": "Abuse Contact",
"org": null,
"email": "domainabuse@cscglobal.com",
"phone": "tel:+1.8887802723",
"street": null,
"city": null,
"postal": null,
"region": null,
"country": null,
"fax": null,
"roles": [
"abuse"
]
}
]
},
"contacts": [
{
"handle": null,
"name": "ESPN, Inc.",
"org": "ESPN, Inc.",
"email": "domreg@espn.com",
"phone": "tel:+1.8607662000",
"street": "935 Middle Street",
"city": "Bristol",
"postal": "06010-1001",
"region": "CT",
"country": "US",
"fax": "tel:+1.8607664502",
"roles": [
"administrative"
]
},
{
"handle": null,
"name": "ESPN, Inc.",
"org": "ESPN, Inc.",
"email": "domreg@espn.com",
"phone": "tel:+1.8607662000",
"street": "935 Middle Street",
"city": "Bristol",
"postal": "06010-1001",
"region": "CT",
"country": "US",
"fax": "tel:+1.8607664502",
"roles": [
"technical"
]
},
{
"handle": null,
"name": "ESPN, Inc.",
"org": "ESPN, Inc.",
"email": "domreg@espn.com",
"phone": "tel:+1.8607662000",
"street": "935 Middle Street",
"city": "Bristol",
"postal": "06010-1001",
"region": "CT",
"country": "US",
"fax": "tel:+1.8607664502",
"roles": [
"registrant"
]
}
],
"dnssec": {
"signed": false
},
"nameservers": [
"ns-846.awsdns-41.net",
"ns-1045.awsdns-02.org",
"ns-1936.awsdns-50.co.uk",
"ns-122.awsdns-15.com"
],
"conformance": [
"rdap_level_0",
"icann_rdap_technical_implementation_guide_0",
"icann_rdap_response_profile_0"
],
"emails": [
"admin@internationaladmin.com",
"domainabuse@cscglobal.com",
"domreg@espn.com"
],
"email_domains": [
"cscglobal.com",
"espn.com",
"internationaladmin.com"
],
"unclassified_emails": [
"admin@internationaladmin.com"
]
},
"record_source": "espn.com"
}
}
Error Handling¶
| Error Code | Description |
|---|---|
| 400 | No domain provided |
| 404 | No data available |
| 422 | Domain validation failed (likely not a domain name) |
Well-formed queries receive a 200 response.