API Documentation

Domain age verification API

Authentication

All API requests require authentication using a Bearer token in the Authorization header.

Authorization: Bearer sk-paperwork-YOUR_API_KEY

Check Domain Age

POSThttps://api.paperwork.to/api/v1/domain/check

Returns domain age and first seen date from Wayback Machine.

Request

curl -X POST https://api.paperwork.to/api/v1/domain/check \
  -H "Authorization: Bearer sk-paperwork-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "apple.com"}'

Request Body

Parameter
Type
Description
domain
string
Domain name to check (e.g., "apple.com")

Response

{
  "domain": "apple.com",
  "age": 29,
  "firstSeen": "1996-10-22"
}

Response Fields

Field
Type
Description
domain
string
Normalized domain name
age
number
Domain age in years
firstSeen
string
First seen date (YYYY-MM-DD)

Errors

Code
Description
401
Missing or invalid API key
403
API key does not have access to domain-checker
400
Invalid domain format
500
Internal server error

Rate Limits

Rate limits depend on your subscription plan. Contact support for custom limits.