# Domain Whois

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/domain/whois` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/domain-whois |

## Description

Retrieve WHOIS registration data for any domain, including registration dates, registrar details, name servers, and contact information.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/domain/whois' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### WHOIS lookup for piloterr.com

```json
{
  "domain": {
    "id": "2236981934_DOMAIN_COM-VRSN",
    "name": "piloterr",
    "domain": "piloterr.com",
    "status": [
      "clientdeleteprohibited",
      "clienttransferprohibited"
    ],
    "punycode": "piloterr.com",
    "extension": "com",
    "created_date": "2018-03-08T23:08:14Z",
    "name_servers": [
      "cruz.ns.cloudflare.com",
      "fred.ns.cloudflare.com"
    ],
    "updated_date": "2023-06-22T07:40:14Z",
    "whois_server": "whois.ovh.com",
    "expiration_date": "2030-03-08T23:08:14Z",
    "created_date_in_time": "2018-03-08T23:08:14Z",
    "updated_date_in_time": "2023-06-22T07:40:14Z",
    "expiration_date_in_time": "2030-03-08T23:08:14Z"
  },
  "registrar": {
    "id": "433",
    "name": "OVH sas",
    "email": "abuse@ovh.net",
    "phone": "+33.972101007",
    "referral_url": "https://www.ovh.com"
  },
  "technical": {
    "fax": "REDACTED FOR PRIVACY",
    "city": "REDACTED FOR PRIVACY",
    "name": "REDACTED FOR PRIVACY",
    "email": "REDACTED FOR PRIVACY",
    "phone": "REDACTED FOR PRIVACY",
    "street": "REDACTED FOR PRIVACY",
    "country": "REDACTED FOR PRIVACY",
    "organization": "REDACTED FOR PRIVACY"
  },
  "registrant": {
    "fax": "REDACTED FOR PRIVACY",
    "city": "REDACTED FOR PRIVACY",
    "name": "REDACTED FOR PRIVACY",
    "email": "REDACTED FOR PRIVACY",
    "phone": "REDACTED FOR PRIVACY",
    "street": "REDACTED FOR PRIVACY",
    "country": "FR"
  },
  "administrative": {
    "fax": "REDACTED FOR PRIVACY",
    "city": "REDACTED FOR PRIVACY",
    "name": "REDACTED FOR PRIVACY",
    "email": "REDACTED FOR PRIVACY",
    "phone": "REDACTED FOR PRIVACY",
    "country": "REDACTED FOR PRIVACY",
    "organization": "REDACTED FOR PRIVACY"
  }
}
```

## Documentation

## Overview
The Domain Whois endpoint returns complete WHOIS registration data for any domain name, including creation dates, registrar information, name servers, and contact details.

## Quickstart
```
GET https://api.piloterr.com/v2/domain/whois?query=piloterr.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Domain name to look up |

## Response fields
| Field | Type | Description |
|---|---|---|
| `domain.created_date` | string | Registration date (ISO 8601) |
| `domain.expiration_date` | string | Expiration date (ISO 8601) |
| `domain.name_servers` | array | DNS name servers |
| `registrar.name` | string | Registrar name |
| `registrant.country` | string | Registrant country |

## Notes
- Privacy protection may redact contact information.
- EPP status codes indicate transfer/delete restrictions.

## Main use cases
- Verify domain ownership and registration age for due diligence
- Monitor competitor domain expiration dates for acquisition opportunities
- Enrich lead records with domain registration context
- Investigate suspicious domains in fraud detection workflows