---
title: "Domain age and registrar (RDAP)"
method: GET
path: "/v1/domain/age"
tags: ["Domain"]
---

# Domain age and registrar (RDAP)

`GET /v1/domain/age`

## Request

- Base URL: `https://afriref.dev`
- URL: `https://afriref.dev/v1/domain/age`
- Auth: one of:
  - API key in header `PAYMENT-SIGNATURE`
  - API key in header `X-PAYMENT`
  - API key in header `X-API-Key`

Use when you need to know who registered a domain (registrar only), how old it is, and whether it is a risky newly-registered domain. $0.005. Domain registration check: registrar (name and IANA ID only), creation, expiry and last-changed dates, status flags, DNSSEC delegation and nameservers from the registry's RDAP, graded pass/warn/fail for newly registered, expiring or held domains.

## Query parameters

- `domain` string, required

## Response `200`

Registration check

- object
  - `domain` string, required
  - `checked_at` string, date-time, required
  - `grade` 'pass' | 'warn' | 'fail' | 'info', required
  - `finding` string, required
  - `fix` string, nullable, required
  - `registration` object, required: Registrar name and IANA ID only; no registrant or contact data
    - `registered_domain` string
    - `registrar` object
      - `name` string, nullable
      - `iana_id` string, nullable
    - `created` string, date-time, nullable
    - `expires` string, date-time, nullable
    - `last_changed` string, date-time, nullable
    - `age_days` integer, nullable
    - `days_to_expiry` integer, nullable
    - `status` string[]
    - `dnssec_delegation_signed` boolean, nullable
    - `nameservers` string[]
  - `notes` string[]

## Other responses

- `400`: Not a valid public domain, or it only resolves to private addresses (free, before payment)
- `402`: Payment Required. HEAD always gets this free preview and is never charged.
- `404`: Domain does not exist (free)
- `422`: The registry publishes no RDAP service (free)
- `429`: Rate limited (free)
- `503`: Registry RDAP did not answer (free, not settled)

## Changes

- **2026-10-19** `d78528e9f644`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/afriref/apis/afriref-pan-african-government-reference-data/changes/v1/domain/age/get.md)

---

[API](https://skmtc.dev/afriref/apis/afriref-pan-african-government-reference-data.md) · [All operations](https://skmtc.dev/afriref/apis/afriref-pan-african-government-reference-data/llms.txt) · [OpenAPI document](https://skmtc.dev/afriref/apis/afriref-pan-african-government-reference-data/revisions/d78528e9f644?raw)