Domain Age

Open in ChatGPT Open in Claude

Registration, last update and expiry dates, registrar and age in days for a domain, from the registry's public RDAP service.

POST https://YOUR_API_HOST/v1/domain-age

Credits and caching

Success billing. 2 credits per registered domain (unregistered domains are free). You are charged only when the lookup finds something; a not-found result is free.
Results are cached per account for 7 days. Repeating the same lookup in that window is free and returns cache_hit: true.
Invalid input, rate limits and errors are never charged.
Read the billing rules for the full picture.

Request

Send a JSON body with Authorization: Bearer <key>. The body can be up to 64 KB.

Field	Type	Required	Notes
`domain`	string	yes	Up to 2048 characters.

Example request

Terminal

curl -X POST https://YOUR_API_HOST/v1/domain-age \
  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

1const response = await fetch("https://YOUR_API_HOST/v1/domain-age", {
2  method: "POST",
3  headers: {
4    Authorization: `Bearer ${process.env.LOOKVALID_API_KEY}`,
5    "Content-Type": "application/json",
6  },
7  body: JSON.stringify({
8    "domain": "example.com"
9  }),
10});
11
12const result = await response.json();
13if (!response.ok) throw new Error(`${result.error.code}: ${result.error.fix}`);
14console.log(result.found, result.data, result.credits_charged);

1import os
2import requests
3
4response = requests.post(
5    "https://YOUR_API_HOST/v1/domain-age",
6    headers={"Authorization": f"Bearer {os.environ['LOOKVALID_API_KEY']}"},
7    json={
8        "domain": "example.com",
9    },
10    timeout=30,
11)
12result = response.json()
13if not response.ok:
14    raise RuntimeError(f"{result['error']['code']}: {result['error']['fix']}")
15print(result["found"], result["data"], result["credits_charged"])

Response

The status is 200 whether or not anything was found. Check found. Every response also carries the X-Request-Id, X-Credits-Charged, X-Credits-Remaining and X-RateLimit-* headers.

Envelope

Field	Type	Notes
`request_id`	string	-
`product`	"domain-age"	-
`found`	boolean	False means the lookup ran and found nothing; it is free.
`reason`	string or null	Why nothing was found; null when found.
`sources`	array of string	Where the data came from, including any attribution the licence requires.
`credits_charged`	integer	0 for a cache hit, a not-found result or an error.
`credits_remaining`	integer	-
`cache_hit`	boolean	True when the account already paid for this lookup within the cache window.
`cache`	object	-

The `data` object

Present when found is true, otherwise null.

Field	Type	Notes
`domain`	string	The domain as queried, lowercase ASCII (punycode for internationalized names)
`registered`	true	-
`created_at`	string or null	ISO 8601 registration time; null when the registry does not publish it
`age_days`	integer or null	Whole days from registration to cache.cached_at (when this answer was computed; a cached answer is not recomputed); null when created_at is null
`updated_at`	string or null	-
`expires_at`	string or null	-
`registrar`	string or null	-
`status`	array of string	EPP/RDAP status codes such as "client transfer prohibited"
`rdap_server`	string	Base URL of the RDAP server that answered

Captured example (2026-10-18)

A real run of this lookup on 2026-10-18, using the request above, which is a public input. The envelope fields are left out.

1{
2  "product": "domain-age",
3  "found": true,
4  "data": {
5    "domain": "example.com",
6    "registered": true,
7    "created_at": "1995-08-14T04:00:00.000Z",
8    "age_days": 11387,
9    "updated_at": "2026-08-14T08:01:43.000Z",
10    "expires_at": "2027-08-13T04:00:00.000Z",
11    "registrar": "RESERVED-Internet Assigned Numbers Authority",
12    "status": [
13      "client delete prohibited",
14      "client transfer prohibited",
15      "client update prohibited"
16    ],
17    "rdap_server": "https://rdap.verisign.com/com/v1/"
18  },
19  "sources": [
20    "RDAP from the registry (https://rdap.verisign.com/com/v1/), found through the IANA RDAP bootstrap file"
21  ]
22}

Errors

400 invalid_input: The request input is invalid.
401 unauthorized: The API key is missing, malformed, revoked or unknown.
402 insufficient_credits: The account does not have enough credits for this lookup. Error code: insufficient_credits. During a trial whose allowance is used up the code is trial_allowance_exhausted: nothing is charged and the customer starts the plan from the billing page.
405 method_not_allowed: This endpoint does not accept that HTTP method.
413 payload_too_large: The request body is too large.
429 rate_limited: Too many requests for this API key.
500 internal_error: An unexpected error occurred.
503 provider_unavailable: The data source for this product is unavailable right now.