▣ DATA VALIDATION · MARKETING

Calculate Domain Age API

What it does

Domain Age tells you how old a domain is from its WHOIS creation date. Send a domain name in the domain query parameter, and get back the domain, the parsed creation_date, and its age in age_days and age_years when that data is available.

Use Domain Age when you need a quick age check for onboarding, risk scoring, spam filtering, or SEO workflows. Older domains can be a useful signal in fraud review and lead qualification, while newly registered domains may need extra scrutiny.

The response is intentionally small and easy to consume: one domain, one creation date, and two age values. If WHOIS data is unavailable or incomplete, the age fields may be null rather than guessed, so you can handle missing registry data explicitly in your application.

Domain Age is a good fit for form validation, enrichment pipelines, and internal tooling that needs a fast domain-age lookup without pulling in a full WHOIS parser.

GET

Calculate how old a domain is from its WHOIS creation date

http://localhost:8080/dosvak/domain-age

QUICKSTARTGUIDE

Quickstart

Look up the age of a domain by sending the required domain query parameter.

curl -X GET "http://localhost:8080/dosvak/domain-age?domain=example.com" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with domain as a string, and age_days, age_years, and creation_date as nullable fields.

{
  "domain": "example.com",
  "age_days": 8765,
  "age_years": 24.0,
  "creation_date": "2000-01-01"
}

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Calculates the age of a domain from its WHOIS creation date. It accepts a domain query parameter and returns a JSON object with the domain plus its age in days, age in years, and creation date when available.

Query Parameter(s)

Attribute	Type	Mandatory	Description
domain	String	Yes	The domain name to evaluate.

Response

Returns a JSON object with domain as a string, age_days as an integer or null, age_years as a number or null, and creation_date as a string or null. The response reflects the domain that was evaluated together with its computed age details when available.

Parameter	Type	Mandatory	Description
domain	String	No	The domain that was evaluated.
age_days	Integer	No	The domain age in days, or null if it cannot be determined.
age_years	Number	No	The domain age in years, or null if it cannot be determined.
creation_date	String	No	The WHOIS creation date, or null if it cannot be determined.

Query parameters

Name

Type

Description

domainREQUIRED

string

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.