How each product works

How to use Domain Age

What Domain Age takes in, which fields it returns and how credits are charged for each lookup.

Last updated 2026-10-22

What it does

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

What you send

Send these fields in the JSON body of the request.

Request fields for Domain Age
Field	Type	Required	Limits
domain	string	Required	up to 2,048 characters

Request fields for Domain Age

What you get back

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Response fields for Domain Age
Field	Type	Meaning
domain	string	The domain as queried, lowercase ASCII (punycode for internationalized names)
registered	boolean
created_at	string	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
expires_at	string
registrar	string
status	list	EPP/RDAP status codes such as "client transfer prohibited"
rdap_server	string	Base URL of the RDAP server that answered

Response fields for Domain Age

What it costs

2 credits per registered domain (unregistered domains are free).

What each outcome costs
Case	Charge
Found	2 credits
Nothing found	0 credits
Repeat inside 7 days	0 credits
Errors and invalid requests	0 credits

What each outcome costs

Run it

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/domain-age with your API key.

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

A request to Domain Age

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

Good to know

A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
When the lookup finds nothing it returns found: false and costs 0 credits.
Invalid input and errors are never charged.
The API allows 200 requests per 10 seconds per key.

Still stuck? Write to hello@lookvalid.com.