Skip to content
DomainTools Technical Documentation

Parsed Domain RDAP API

Introduction

Section titled “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

Section titled “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

Section titled “Authentication”

The Parsed Domain-RDAP API supports Hash-Based Message Authentication Codes (HMAC) and open key authentication.

HMAC

Section titled “HMAC”

Parameters

Section titled “Parameters”
Required ParameterValue
api_usernameYour API username
timestampCurrent timestamp, in ISO 8601 format, e.g.: 2024-07-01T14:37:59-0800 2024-07-01T22:37:59Z 2024-07-02T10:37:59+1200
signatureHMAC signature of your request, using the MD5, SHA1, or SHA256 hashing algorithm

Example

Section titled “Example”
https://api.domaintools.com/v1/domaintools.com/rdap/parsed/?api_username={YOUR_USERNAME}&signature={SIGNATURE_VALUE}&timestamp={TIMESTAMP_VALUE}

Open Key

Section titled “Open Key”

Parameters

Section titled “Parameters”
Required ParameterValue
api_usernameYour API username
api_keyYour API key

Example

Section titled “Example”
https://api.domaintools.com/v1/domaintools.com/rdap/parsed/?api_username=$DOMAINTOOLS_USERNAME&api_key=$DOMAINTOOLS_API_KEY

Set DOMAINTOOLS_USERNAME and DOMAINTOOLS_API_KEY in your environment before running.

Base URL

Section titled “Base URL”

https://api.domaintools.com/v1/

Endpoint

Section titled “Endpoint”

GET /{domain}/rdap/parsed

Path Parameter

Section titled “Path Parameter”

Specify your queried domain in the endpoint path:

ParameterTypeDescription
DomainstringThe domain name to query (e.g., example.com).

Request Example

Section titled “Request Example”
https://api.domaintools.com/v1/example.com/rdap/parsed/?api_username=$DOMAINTOOLS_USERNAME&api_key=$DOMAINTOOLS_API_KEY

Response Contents

Section titled “Response Contents”

Raw and Parsed Records for Registry and/or Registrar

Section titled “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"
    }
}

Response Codes and Error Handling

Section titled “Response Codes and Error Handling”

Well-formed queries receive a 200 OK response.

Status CodeDescription
400No domain provided
403Authentication failed (forbidden)
404No data available
422Domain validation failed (likely not a domain name)
500Internal server error
503Service limit reached

Full Response Example

Section titled “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"
    }
}