---
title: "Get a domain's registration age and expiration via RDAP"
method: POST
path: "/api/v1/domain/age"
tags: ["Domain"]
---

# Get a domain's registration age and expiration via RDAP

`POST /api/v1/domain/age`

## Request

- Base URL: `https://firstsales.io`
- URL: `https://firstsales.io/api/v1/domain/age`
- Auth: none required

Queries RDAP (the modern WHOIS replacement) for registration date, expiration date, last-updated date, registrar, and status, and computes age in days/months/years. Use this to flag newly-registered domains, a common spam/fraud signal. Rate limit: 10 requests/minute per IP.

## Request body

- object
  - `domain` string, required

## Response `200`

Domain age/registration details.

- DomainAgeResult
  - `domain` string, required
  - `registrationDate` string, nullable, required
  - `expirationDate` string, nullable, required
  - `lastUpdated` string, nullable, required
  - `ageInDays` number, nullable, required
  - `ageInMonths` number, nullable, required
  - `ageInYears` number, nullable, required
  - `registrar` string, nullable, required
  - `status` string[], required
  - `name` string, required

## Other responses

- `400`: Invalid request — bad input, missing field, or malformed value.
- `404`: Domain not found in the RDAP registry.
- `429`: Rate limit exceeded for this endpoint. Wait Retry-After seconds and retry.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/firstsales/apis/firstsales-public-api.md) · [All operations](https://skmtc.dev/firstsales/apis/firstsales-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firstsales/apis/firstsales-public-api/revisions/3856191adf12?raw)