RDAP Lookup API
Instant RDAP lookup for domains. Pull registrar, status, and expiry data in seconds. Use this reference to pick the right endpoint and see exactly what it returns.
Operations
GET /v1/rdap
GET
/v1/rdap
Credits: 2
Query parameters
| Parameter | Type | required |
|---|---|---|
| query | string | optional |
| type |
string
Allowed values
domainipautnum
|
optional |
| domain | string | optional |
Response fields
| Field | Type |
|---|---|
query |
string |
type |
string |
status |
string |
rdap |
object |
rdap.objectClassName |
string |
rdap.handle |
string |
rdap.name |
string |
rdap.startAddress |
string |
rdap.endAddress |
string |
rdap.ipVersion |
string |
Example request
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?query=example.com"
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?type=ip&query=8.8.8.8"
curl -G -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap" \
--data "type=ip" \
--data-urlencode "query=2001:4860:4860::8888/128"
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?type=autnum&query=AS174"
Example response
{
"query": "8.8.8.8",
"type": "ip",
"status": "found",
"rdap": {
"objectClassName": "ip network",
"handle": "NET-8-8-8-0-2",
"name": "LVLT-GOGL-8-8-8",
"startAddress": "8.8.8.0",
"endAddress": "8.8.8.255",
"ipVersion": "v4"
}
}
HTTP status codes
200OK400Bad Request401Unauthorized402Payment Required429Too Many Requests
POST /v1/rdap/bulk
POST
/v1/rdap/bulk
Credits: 2/item
Query parameters
| Parameter | Type | required |
|---|---|---|
| dry_run |
string
Allowed values
true
|
optional |
Body parameters
| Parameter | Type | required |
|---|---|---|
| queries | string[] | required |
| type |
string
Allowed values
domainipautnum
Default
domain
|
optional |
Response fields
| Field | Type |
|---|---|
results[] |
unknown[] |
meta |
object |
meta.total |
integer |
meta.succeeded |
integer |
meta.failed |
integer |
meta.max_items |
integer |
meta.credits_per_item |
integer |
meta.duration_ms |
integer |
Example request
curl -X POST "https://domscan.net/v1/rdap/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"queries": [
"example.com",
"cloudflare.com"
],
"type": "domain"
}'const response = await fetch("https://domscan.net/v1/rdap/bulk", {
method: "POST",
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"queries": [
"example.com",
"cloudflare.com"
],
"type": "domain"
}),
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.post(
"https://domscan.net/v1/rdap/bulk",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
json={
"queries": [
"example.com",
"cloudflare.com",
],
"type": "domain",
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"queries": [
"example.com",
"cloudflare.com"
],
"type": "domain"
}`)
req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/rdap/bulk", body)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/rdap/bulk")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
"queries" => [
"example.com",
"cloudflare.com"
],
"type" => "domain"
})
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Example response
{
"results": [
{
"input": "example",
"data": {}
}
],
"meta": {
"total": 1,
"succeeded": 1,
"failed": 1,
"max_items": 10,
"credits_per_item": 1,
"duration_ms": 1
}
}
HTTP status codes
200OK400Bad Request401Unauthorized402Payment Required409HTTP 409422HTTP 422429Too Many Requests