# Domain WHOIS

Returns the current WHOIS registration record of a domain: registrar, registrant, creation, update and expiry dates, name servers and status codes.

Source: https://docs.deepinfo.com/reference/lookup/domain-whois/

Last updated: 2026-09-27

---
`GET https://api.deepinfo.com/v1/lookup/whois`

Returns the **current** WHOIS registration record of a domain: registrar, registrant, creation, update and expiry dates, name servers and status codes. The record is queried in real time. The response includes both the raw WHOIS text and a parsed version.

## Authentication

Send your API key in the `apikey` request header.

## Query Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `domain` | Required | Domain name, e.g. `deepinfo.com`. Subdomains are accepted (`www.deepinfo.com`); IP addresses are not. | `deepinfo.com` |

## Response Fields

| Field | Description |
|---|---|
| `domain_name` | The queried domain |
| `raw` | Raw WHOIS text as returned by the WHOIS server |
| `parsed` | Parsed record, with the `parsed.*` fields below. `null` if the record could not be parsed |
| `parsed.create_date` | Registration date |
| `parsed.update_date` | Date of the last update |
| `parsed.expiry_date` | Expiry date |
| `parsed.registrar` | Registrar |
| `parsed.registrant.name` | Registrant name |
| `parsed.registrant.organization` | Registrant organization |
| `parsed.registrant.street` | Registrant street address |
| `parsed.registrant.city` | Registrant city |
| `parsed.registrant.state` | Registrant state or province |
| `parsed.registrant.postal_code` | Registrant postal code |
| `parsed.registrant.country` | Registrant country |
| `parsed.registrant.phone` | Registrant phone number |
| `parsed.registrant.email` | Registrant e-mail address |
| `parsed.name_servers` | Name servers |
| `parsed.domain_status` | Domain status codes |
| `parsed.whois_server` | WHOIS server |
| `check_date` | When the lookup was performed (UTC) |
| `parse_code` | Parser status code; `null` when parsing succeeded |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

| Field | Type |
|---|---|
| `domain_name` | string |
| `raw` | string |
| `parsed` | object |
| `parsed.uid` | string |
| `parsed.create_date` | string |
| `parsed.update_date` | string |
| `parsed.expiry_date` | string |
| `parsed.registrar` | string |
| `parsed.registrant` | object |
| `parsed.registrant.name` | string |
| `parsed.registrant.organization` | string |
| `parsed.registrant.street` | string |
| `parsed.registrant.city` | string |
| `parsed.registrant.state` | string |
| `parsed.registrant.postal_code` | string |
| `parsed.registrant.country` | string |
| `parsed.registrant.phone` | string |
| `parsed.registrant.email` | string |
| `parsed.name_servers` | array<string> |
| `parsed.domain_status` | array<string> |
| `parsed.whois_server` | string |
| `check_date` | string |
| `parse_code` | null |

## Errors

`400` if `domain` is missing or not a valid domain. See [Getting Started → Errors](/getting-started/errors/).

## Examples

### 200 · deepinfo.com

```bash
curl 'https://api.deepinfo.com/v1/lookup/whois?domain=deepinfo.com' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `ratelimit-limit: 10` · `ratelimit-remaining: 9` · `ratelimit-reset: 1` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "domain_name": "deepinfo.com",
  "raw": "Domain Name: DEEPINFO.COM\n   Registry Domain ID: 71858956_DOMAIN_COM-VRSN\n   Registrar WHOIS Server: whois.uniregistrar.com\n   Registrar URL: http://www.uniregistry.com\n   Updated Date: 2025-08-19T07:33:45Z\n   Creation Date: 2001-06-05T02:57:08Z\n   Registry Expiry Date: 2028-10-20T11:59:59Z\n   Registrar: GoDaddy Online Services Cayman Islands Ltd.\n   Registrar IANA ID: 1659\n   Registrar Abuse Contact Email: abuse@uniregistry.com\n   Registrar Abuse Contact Phone: +1 4805058800\n   Domain Status: clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited\n   Domain Status: clientRenewProhibited https://icann.org/epp#clientRenewProhibited\n   Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\n   Domain Status: clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited\n   Name Server: MAY.NS.CLOUDFLARE.COM\n   Name Server: SIMON.NS.CLOUDFLARE.COM\n   DNSSEC: unsigned\n…",
  "parsed": {
    "uid": "3bafd4dd0782078cdf8163ad780370d9",
    "create_date": "2001-06-05T02:57:08Z",
    "update_date": "2025-08-19T07:33:45Z",
    "expiry_date": "2028-10-20T11:59:59Z",
    "registrar": "godaddy online services cayman islands ltd.",
    "registrant": {
      "name": "registration private",
      "organization": "domains by proxy, llc",
      "street": "domainsbyproxy.com",
      "city": "tempe",
      "state": "arizona",
      "postal_code": "85281",
      "country": "us",
      "phone": "+1.4806242599",
      "email": "https://www.godaddy.com/whois/results.aspx?domain=deepinfo.com&action=contactdomainowner"
    },
    "name_servers": [
      "may.ns.cloudflare.com",
      "simon.ns.cloudflare.com"
    ],
    "domain_status": [
      "clientdeleteprohibited",
      "clientrenewprohibited",
      "clienttransferprohibited",
      "clientupdateprohibited"
    ],
    "whois_server": "whois.uniregistrar.com"
  },
  "check_date": "2026-09-22T12:25:50Z",
  "parse_code": null
}
```

### 400 · Invalid Domain

```bash
curl 'https://api.deepinfo.com/v1/lookup/whois?domain=not_a_domain' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `ratelimit-limit: 10` · `ratelimit-remaining: 9` · `ratelimit-reset: 1` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "code": 10400,
  "parameters": [
    {
      "param": "domain",
      "subcode": 10001,
      "details": [
        "Domain extension is not given in the input."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```

## Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and its response: [Domain WHOIS Examples by TLD](/reference/lookup/domain-whois/examples/).

- [WHOIS for .com (nic.com)](/reference/lookup/domain-whois/examples/com/): The WHOIS record of nic.com, in the .com registry's format.
- [WHOIS for .org (nic.org)](/reference/lookup/domain-whois/examples/org/): The WHOIS record of nic.org, in the .org registry's format.
- [WHOIS for .de (nic.de)](/reference/lookup/domain-whois/examples/de/): The WHOIS record of nic.de, in the .de registry's format.
- [WHOIS for .jp (nic.jp)](/reference/lookup/domain-whois/examples/jp/): The WHOIS record of nic.jp, in the .jp registry's format.