Skip to content
Website & Domain

Domain Age

Registration date, exact age, expiry and registrar, straight from the registry.

POST/v1/domain-age
2 creditsBulk supportedGlobal, all RDAP-enabled TLDs
Request
curl -X POST https://api.1lookup.dev/v1/domain-age \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'
Response
{
  "success": true,
  "data": {
    "domain": "example.com",
    "registered": true,
    "created_at": "2014-03-18T16:22:07Z",
    "updated_at": "2026-02-20T09:11:43Z",
    "expires_at": "2027-03-18T16:22:07Z",
    "age": {
      "years": 12,
      "months": 8,
      "days": 1,
      "total_days": 4629
    },
    "registrar": {
      "name": "Example Registrar, Inc.",
      "url": "https://registrar.example"
    },
    "status": [
      "clientTransferProhibited",
      "clientDeleteProhibited"
    ],
    "nameservers": [
      "ns1.dnshost.example",
      "ns2.dnshost.example"
    ],
    "source": "rdap"
  },
  "meta": {
    "credits_used": 2,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}

Authorization

Authorizationstring<bearer>required

Your API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.

Body

Send the fields as a JSON object with Content-Type: application/json.

domainstring<domain>required

Domain. Example: example.com

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your own identifier, echoed back in meta and shown in lookup history.

Response

A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.

successboolean

true when the lookup ran.

data.created_atstring

When the domain was registered, as recorded by the registry.

data.age.total_daysnumber

Age in days, with a years, months and days breakdown beside it.

data.expires_atstring

When the current registration term ends.

data.updated_atstring

The last time the registry record changed, for example after a renewal or transfer.

data.registrar.namestring

The company the domain is registered through.

data.statusarray

Registry status values such as clientTransferProhibited or pendingDelete.

data.nameserversarray

The nameservers listed on the registry record.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote this when you contact support.

Errors

A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn upstream source did not answer in time. Safe to retry.

Billing

2 credits. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.

Product overview and use cases