RDAP
Ask the official registries who holds a domain name, an IP network or an AS number with RDAP, the JSON successor of whois. The right registry is found in the IANA bootstrap files, and the result gives the registrar, the status, the registration and expiration dates, the name servers and the published contacts. Typical uses: watch the expiration dates of the domain names of a company, find the owner and the country of the network behind an IP address seen in a log, check whether a domain name is free.
rdap domain <domain>
Description
The registration of a domain name (IDN accepted, sent in ASCII): {query, found, url, object_class, handle, ldh_name, unicode_name, status, registrar: {name, iana_id, abuse_email, abuse_phone}, events, nameservers, dnssec, entities}
The registration of a domain name (IDN accepted, sent in ASCII): {query, found, url, object_class, handle, ldh_name, unicode_name, status, registrar: {name, iana_id, abuse_email, abuse_phone}, events, nameservers, dnssec, entities}
Parameters
domain: The domain name, ex: example.com - String - required
domain: The domain name, ex: example.com - String - required
admin
rdap domain "example.com"
mentdb
{"query": "example.com", "found": true, "url": "https://rdap.verisign.com/com/v1/domain/example.com", "object_class": "domain", "handle": "2336799_DOMAIN_COM-VRSN", "ldh_name": "example.com", "unicode_name": null, "status": ["client delete prohibited", "client transfer prohibited", "client update prohibited"], "registrar": {"name": "RESERVED-Internet Assigned Numbers Authority", "iana_id": "376", "abuse_email": null, "abuse_phone": null}, "events": {"registration": "1995-08-14T04:00:00Z", "expiration": "2027-08-13T04:00:00Z", "last_changed": "2026-08-14T08:01:43Z", "last_update_of_rdap_database": "2026-11-11T14:45:15Z"}, "nameservers": ["elliott.ns.cloudflare.com", "hera.ns.cloudflare.com"], "dnssec": true, "entities": [{"roles": ["registrar"], "handle": "376", "name": "RESERVED-Internet Assigned Numbers Authority", "organization": null, "email": null}, {"roles": ["abuse"], "handle": null, "name": null, "organization": null, "email": null}]}
Fixed result of a real call made on 2026-11-11 (the registries change their data): a name that is not registered
admin
rdap domain "mentdb-no-such-domain-4242.com"
mentdb
{"query": "mentdb-no-such-domain-4242.com", "found": false, "url": "https://rdap.verisign.com/com/v1/domain/mentdb-no-such-domain-4242.com"}
A text that is not a domain name is refused before any connection
admin
rdap domain "not a domain"
mentdb
ERROR: Sorry, an error appears (the parameter 'domain' is not a valid domain name).
rdap domain <domain> <json_params>
Description
The registration of a domain name with parameters: timeout_ms (10000), max_bytes (2097152), max_redirects (3), insecure (false), allow_http (false), cache_ttl_s (86400, 0: the bootstrap file is read again), bootstrap_url, server, raw (false)
The registration of a domain name with parameters: timeout_ms (10000), max_bytes (2097152), max_redirects (3), insecure (false), allow_http (false), cache_ttl_s (86400, 0: the bootstrap file is read again), bootstrap_url, server, raw (false)
Parameters
domain: The domain name - String - required
json_params: The parameters - String - required
domain: The domain name - String - required
json_params: The parameters - String - required
admin
rdap domain "wikipedia.org" "{\"timeout_ms\": 5000}"
mentdb
{"query": "wikipedia.org", "found": true, "url": "https://rdap.publicinterestregistry.org/rdap/domain/wikipedia.org", "object_class": "domain", "handle": null, "ldh_name": "wikipedia.org", "unicode_name": "wikipedia.org", "status": ["client delete prohibited", "client transfer prohibited", "client update prohibited"], "registrar": {"name": "MarkMonitor Inc.", "iana_id": "292", "abuse_email": "abusecomplaints@markmonitor.com", "abuse_phone": "+1.2083895740"}, "events": {"transfer": "2012-03-09T16:33:50.754Z", "expiration": "2027-01-13T00:12:14Z", "registration": "2001-01-13T00:12:14.754Z", "last_changed": "2026-08-12T08:47:19.41Z", "last_update_of_rdap_database": "2026-11-11T14:45:27.087Z"}, "nameservers": ["ns0.wikimedia.org", "ns1.wikimedia.org", "ns2.wikimedia.org"], "dnssec": false, "entities": [{"roles": ["registrar"], "handle": "292", "name": "MarkMonitor Inc.", "organization": null, "email": null}, {"roles": ["abuse"], "handle": null, "name": null, "organization": null, "email": "abusecomplaints@markmonitor.com"}]}
No server on this port: the error says why
admin
rdap domain "example.com" "{\"bootstrap_url\": \"http://127.0.0.1:1/\", \"timeout_ms\": 2000}"
mentdb
ERROR: Sorry, an error appears (the RDAP request to 127.0.0.1 failed: connection refused).
rdap ip <ip>
Description
The network of an IPv4 or IPv6 address, or of a prefix such as 192.0.2.0/24: {query, found, url, object_class, handle, start_address, end_address, ip_version, cidr, name, type, country, parent_handle, status, events, entities}
The network of an IPv4 or IPv6 address, or of a prefix such as 192.0.2.0/24: {query, found, url, object_class, handle, start_address, end_address, ip_version, cidr, name, type, country, parent_handle, status, events, entities}
Parameters
ip: The IP address or prefix (a host name is refused) - String - required
ip: The IP address or prefix (a host name is refused) - String - required
admin
rdap ip "8.8.8.8"
mentdb
{"query": "8.8.8.8", "found": true, "url": "https://rdap.arin.net/registry/ip/8.8.8.8", "object_class": "ip network", "handle": "NET-8-8-8-0-2", "start_address": "8.8.8.0", "end_address": "8.8.8.255", "ip_version": "v4", "cidr": ["8.8.8.0/24"], "name": "GOGL", "type": "DIRECT ALLOCATION", "country": null, "parent_handle": "NET-8-0-0-0-0", "status": ["active"], "events": {"last_changed": "2023-12-28T17:24:56-05:00", "registration": "2023-12-28T17:24:33-05:00"}, "entities": [{"roles": ["registrant"], "handle": "GOGL", "name": "Google LLC", "organization": null, "email": null}, {"roles": ["abuse"], "handle": "ABUSE5250-ARIN", "name": "Abuse", "organization": "Google Inc.", "email": "network-abuse@google.com"}, {"roles": ["technical", "administrative"], "handle": "ZG39-ARIN", "name": "Google LLC", "organization": "Google LLC", "email": "arin-contact@google.com"}]}
A host name is refused
admin
rdap ip "www.example.com"
mentdb
ERROR: Sorry, an error appears (the parameter 'ip' must be an IPv4 or IPv6 address (a host name is not resolved), ex: 192.0.2.1 or 2001:db8::1).
rdap ip <ip> <json_params>
Description
The network of an IP address with the parameters of rdap domain
The network of an IP address with the parameters of rdap domain
Parameters
ip: The IP address or prefix - String - required
json_params: The parameters - String - required
ip: The IP address or prefix - String - required
json_params: The parameters - String - required
admin
rdap ip "2001:4860:4860::8888" "{\"timeout_ms\": 5000}"
mentdb
{"query": "2001:4860:4860::8888", "found": true, "url": "https://rdap.arin.net/registry/ip/2001:4860:4860::8888", "object_class": "ip network", "handle": "NET6-2001-4860-1", "start_address": "2001:4860::", "end_address": "2001:4860:ffff:ffff:ffff:ffff:ffff:ffff", "ip_version": "v6", "cidr": ["2001:4860::/32"], "name": "GOOGLE-IPV6", "type": "DIRECT ALLOCATION", "country": null, "parent_handle": "NET6-2001-4800-0", "status": ["active"], "events": {"last_changed": "2012-02-24T09:44:34-05:00", "registration": "2005-03-14T11:31:08-05:00"}, "entities": [{"roles": ["registrant"], "handle": "GOGL", "name": "Google LLC", "organization": null, "email": null}, {"roles": ["abuse"], "handle": "ABUSE5250-ARIN", "name": "Abuse", "organization": "Google Inc.", "email": "network-abuse@google.com"}, {"roles": ["technical", "administrative"], "handle": "ZG39-ARIN", "name": "Google LLC", "organization": "Google LLC", "email": "arin-contact@google.com"}, {"roles": ["technical", "noc", "abuse"], "handle": "ZG39-ARIN", "name": "Google LLC", "organization": "Google LLC", "email": "arin-contact@google.com"}]}
rdap asn <asn>
Description
An autonomous system number (15169 or AS15169): {query, found, url, object_class, handle, start_autnum, end_autnum, name, type, country, status, events, entities}
An autonomous system number (15169 or AS15169): {query, found, url, object_class, handle, start_autnum, end_autnum, name, type, country, status, events, entities}
Parameters
asn: The AS number - String - required
asn: The AS number - String - required
admin
rdap asn "AS15169"
mentdb
{"query": "AS15169", "found": true, "url": "https://rdap.arin.net/registry/autnum/15169", "object_class": "autnum", "handle": "AS15169", "start_autnum": 15169, "end_autnum": 15169, "name": "GOOGLE", "type": null, "country": null, "status": ["active"], "events": {"last_changed": "2012-02-24T09:44:34-05:00", "registration": "2000-03-30T00:00:00-05:00"}, "entities": [{"roles": ["registrant"], "handle": "GOGL", "name": "Google LLC", "organization": null, "email": null}, {"roles": ["abuse"], "handle": "ABUSE5250-ARIN", "name": "Abuse", "organization": "Google Inc.", "email": "network-abuse@google.com"}, {"roles": ["technical", "administrative"], "handle": "ZG39-ARIN", "name": "Google LLC", "organization": "Google LLC", "email": "arin-contact@google.com"}, {"roles": ["technical"], "handle": "ZG39-ARIN", "name": "Google LLC", "organization": "Google LLC", "email": "arin-contact@google.com"}]}
Not a number
admin
rdap asn "AS-GOOGLE"
mentdb
ERROR: Sorry, an error appears (the parameter 'asn' must be an AS number, ex: 15169 or AS15169).
rdap asn <asn> <json_params>
Description
An autonomous system number with the parameters of rdap domain
An autonomous system number with the parameters of rdap domain
Parameters
asn: The AS number - String - required
json_params: The parameters - String - required
asn: The AS number - String - required
json_params: The parameters - String - required
admin
rdap asn "15169" "{\"max_redirects\": 1}"
mentdb
{"query": "AS15169", "found": true, "url": "https://rdap.arin.net/registry/autnum/15169", "object_class": "autnum", "handle": "AS15169", "start_autnum": 15169, "end_autnum": 15169, "name": "GOOGLE", "type": null, "country": null, "status": ["active"], "events": {"last_changed": "2012-02-24T09:44:34-05:00", "registration": "2000-03-30T00:00:00-05:00"}, "entities": [{"roles": ["registrant"], "handle": "GOGL", "name": "Google LLC", "organization": null, "email": null}, {"roles": ["abuse"], "handle": "ABUSE5250-ARIN", "name": "Abuse", "organization": "Google Inc.", "email": "network-abuse@google.com"}, {"roles": ["technical", "administrative"], "handle": "ZG39-ARIN", "name": "Google LLC", "organization": "Google LLC", "email": "arin-contact@google.com"}, {"roles": ["technical"], "handle": "ZG39-ARIN", "name": "Google LLC", "organization": "Google LLC", "email": "arin-contact@google.com"}]}
