# Domain Age Checker
> Give it a list of domains and get back registration date, expiration date, age, and time remaining — instantly.

## Agent Summary
- FQN: `domain-age-checker.underscoredone.com`
- Category: network
- Operator: _done
- Version: 1.0.0
- Endpoints: 1
- Pricing: $0.01
- Page: https://underscoredone.com/domain_age_checker
- Markdown: https://domain-age-checker.underscoredone.com/index.md
- OpenAPI: https://domain-age-checker.underscoredone.com/openapi.json

## Service URL
https://domain-age-checker.underscoredone.com

## Use Case
Send a list of domain names and this tool tells you exactly how old each one is, when it was first registered, when it expires, and how much time is left before expiration. Great for spotting brand-new suspicious domains, researching competitors, or evaluating domains before buying or linking to them. Works with over 100 domain extensions worldwide.

## How to Call
POST a JSON body with a 'domains' list of domain name strings (plain domains or full URLs both work). Each result includes 'domainName', 'age' as a human-readable string, 'registrationDate', 'lastUpdateDate', 'expirationDate', 'expiringIn' as a human-readable string, and 'status' which is 'success' or 'error'. If WHOIS data cannot be retrieved for a domain, that entry will have status 'error' and an 'error' field explaining why — other domains in the batch still return normally. Strip URLs down to bare domains before lookup. Batch size is capped at 50 domains per request.

## Endpoint
| Method | URL | Price | Description |
|--------|-----|-------|-------------|
| POST | `https://domain-age-checker.underscoredone.com/lookup` | $0.01/request | Check how old a list of domains is and when they expire |

## Example Request
```json
{
  "domains": [
    "google.com",
    "openai.com",
    "github.com"
  ]
}
```

## Example Response
```json
{
  "api_version": "1.0.0",
  "results": [
    {
      "domainName": "google.com",
      "age": "26 Years 10 Months 12 Days",
      "registrationDate": "1997-09-15",
      "lastUpdateDate": "2024-09-07",
      "expirationDate": "2028-09-14",
      "expiringIn": "3 Years 1 Month 18 Days",
      "status": "success"
    },
    {
      "domainName": "openai.com",
      "age": "9 Years 3 Months 5 Days",
      "registrationDate": "2015-04-18",
      "lastUpdateDate": "2024-11-01",
      "expirationDate": "2026-04-18",
      "expiringIn": "11 Months 22 Days",
      "status": "success"
    }
  ],
  "total": 2,
  "succeeded": 2,
  "failed": 0,
  "processed_at": "2024-07-27T14:22:01Z"
}
```

## Errors
| Status | Meaning |
|--------|---------|
| 400 | Something went wrong while processing your request — for example, the domains list is empty, every entry is invalid, or the batch is too large. |
| 422 | The request was sent in the wrong format — for example, 'domains' was not included or was not a list. |
| 402 | Payment required — send X-PAYMENT header |