WHOIS Lookup API

What you get

Get WHOIS information for a domain including registrar, dates, and status.

SynchronousBulkRESTMCPSDKInteractive tool

Choose this product when

Who it is for

Use focused checks for a single decision or assemble a broader profile when context matters.

Choose this product when

Choose this for WHOIS records and parsed fields, which may be redacted, incomplete, or unavailable.

What you get

Get WHOIS information for a domain including registrar, dates, and status.

Endpoints

Review the supported operations, inputs, outputs, execution modes, and response limits before integrating.

GET /v1/whois View API reference

GET /v2/whois View API reference

POST /v1/whois/bulk View API reference

GET /v1/whois/history View API reference

Credits and authentication

3 Authentication required. Check the operation reference for the exact cost and any per-item pricing.

Example operation

Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.

GET /v1/whois

Query Parameters

Parameter	Type	required
domain	string	required

Response Fields

Field	Type
`domain`	string
`registered`	boolean \| null
`available`	boolean \| null
`registrar`	string \| null
`registrar_url`	string \| null
`registrar_iana_id`	string \| null
`created_date`	string \| null
`updated_date`	string \| null
`expiry_date`	string \| null
`domain_age_days`	integer \| null
`domain_age_years`	integer \| null
`is_newly_registered`	boolean
`days_until_expiry`	integer \| null
`transfer_locked`	boolean
`nameservers[]`	string[]
`status[]`	string[]
`dnssec`	boolean
`contacts`	object
`contacts.registrant`	object
`contacts.registrant.name`	string \| null
`contacts.registrant.organization`	string \| null
`contacts.registrant.email`	string \| null
`contacts.registrant.phone`	string \| null
`contacts.registrant.fax`	string \| null
`contacts.registrant.address`	object
`contacts.registrant.address.street`	string \| null
`contacts.registrant.address.city`	string \| null
`contacts.registrant.address.state`	string \| null
`contacts.registrant.address.postal_code`	string \| null
`contacts.registrant.address.country`	string \| null
`contacts.registrant.role`	string
`contacts.admin`	object
`contacts.admin.name`	string \| null
`contacts.admin.organization`	string \| null
`contacts.admin.email`	string \| null
`contacts.admin.phone`	string \| null
`contacts.admin.fax`	string \| null
`contacts.admin.address`	object
`contacts.admin.address.street`	string \| null
`contacts.admin.address.city`	string \| null
`contacts.admin.address.state`	string \| null
`contacts.admin.address.postal_code`	string \| null
`contacts.admin.address.country`	string \| null
`contacts.admin.role`	string
`contacts.tech`	object
`contacts.tech.name`	string \| null
`contacts.tech.organization`	string \| null
`contacts.tech.email`	string \| null
`contacts.tech.phone`	string \| null
`contacts.tech.fax`	string \| null
`contacts.tech.address`	object
`contacts.tech.address.street`	string \| null
`contacts.tech.address.city`	string \| null
`contacts.tech.address.state`	string \| null
`contacts.tech.address.postal_code`	string \| null
`contacts.tech.address.country`	string \| null
`contacts.tech.role`	string
`contacts.billing`	object
`contacts.billing.name`	string \| null
`contacts.billing.organization`	string \| null
`contacts.billing.email`	string \| null
`contacts.billing.phone`	string \| null
`contacts.billing.fax`	string \| null
`contacts.billing.address`	object
`contacts.billing.address.street`	string \| null
`contacts.billing.address.city`	string \| null
`contacts.billing.address.state`	string \| null
`contacts.billing.address.postal_code`	string \| null
`contacts.billing.address.country`	string \| null
`contacts.billing.role`	string
`privacy`	object
`privacy.is_private`	boolean
`privacy.privacy_service`	string \| null
`privacy.detected_patterns[]`	string[]
`raw_rdap_link`	string \| null
`raw_whois`	string \| null
`abuse_contact`	object \| null
`registry_domain_id`	string \| null
`registrar_whois_server`	string \| null
`traditional_contacts`	object
`nameserver_ips[]`	object[]
`nameserver_ips[]`	object
`nameserver_ips[].name`	string
`nameserver_ips[].ipv4`	string \| null
`nameserver_ips[].ipv6`	string \| null
`checked_at`	string
`query_time_ms`	integer
`summary`	object
`edge_summary`	object
`edge_summary.relay_configured`	boolean
`edge_summary.data_sources[]`	string[]
`edge_summary.authoritative_source`	string
`edge_summary.relay_whois_used`	boolean
`edge_summary.raw_whois_available`	boolean
`edge_summary.parse_error_count`	integer \| null
`edge_summary.registered`	boolean \| null
`edge_summary.available`	boolean \| null
`edge_summary.registration_age_days`	integer \| null
`edge_summary.days_until_expiry`	integer \| null
`edge_summary.expires_within_30_days`	boolean \| null
`edge_summary.transfer_locked`	boolean \| null
`edge_summary.privacy_protected`	boolean \| null
`edge_summary.dnssec`	boolean \| null
`edge_summary.nameserver_count`	integer
`edge_summary.contact_roles_available[]`	string[]
`edge_summary.abuse_contact_available`	boolean
`edge_summary.registrar_whois_server`	string \| null
`meta`	object

Example Request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/whois?domain=example.com"

Example Response

{
  "domain": "example.com",
  "registered": false,
  "available": true,
  "registrar": "example",
  "registrar_url": "https://example.com",
  "registrar_iana_id": "example",
  "created_date": "2026-08-27T12:00:00Z",
  "updated_date": "2026-08-27T12:00:00Z",
  "expiry_date": "2026-08-27T12:00:00Z",
  "domain_age_days": 1,
  "domain_age_years": 1,
  "is_newly_registered": false,
  "days_until_expiry": 1,
  "transfer_locked": false,
  "nameservers": [
    "example"
  ],
  "status": [
    "available"
  ],
  "dnssec": false,
  "contacts": {
    "registrant": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    },
    "admin": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    },
    "tech": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    },
    "billing": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    }
  },
  "privacy": {
    "is_private": false,
    "privacy_service": "example",
    "detected_patterns": [
      "example"
    ]
  },
  "raw_rdap_link": "example",
  "raw_whois": "example",
  "abuse_contact": {},
  "registry_domain_id": "example",
  "registrar_whois_server": "example",
  "traditional_contacts": {},
  "nameserver_ips": [
    {
      "name": "example",
      "ipv4": "192.0.2.1",
      "ipv6": "2001:db8::1"
    }
  ],
  "checked_at": "2026-08-27T12:00:00Z",
  "query_time_ms": 1,
  "summary": {},
  "edge_summary": {
    "relay_configured": false,
    "data_sources": [
      "rdap"
    ],
    "authoritative_source": "rdap",
    "relay_whois_used": false,
    "raw_whois_available": true,
    "parse_error_count": 1,
    "registered": false,
    "available": true,
    "registration_age_days": 1,
    "days_until_expiry": 1,
    "expires_within_30_days": false,
    "transfer_locked": false,
    "privacy_protected": false,
    "dnssec": false,
    "nameserver_count": 1,
    "contact_roles_available": [
      "example"
    ],
    "abuse_contact_available": true,
    "registrar_whois_server": "example"
  },
  "meta": {}
}

Limits and evidence boundaries

Results describe observed public evidence and its provenance.

Unknown means the requested fact could not be determined from the available evidence.

Bulk operations process multiple supported inputs while preserving documented item-level outcomes.

Cached indicates that stored evidence was used; review freshness metadata where provided.

Evidence can change over time; use timestamps and freshness fields when provided.

Reviewed 2026-08-22

Related products

Frequently asked questions

Where can I find the WHOIS Lookup request and response reference?

Use the API reference for WHOIS Lookup to review parameters, response fields, examples, status codes, and supported operation modes.

How should I interpret unknown or incomplete results from WHOIS Lookup?

Unknown or partial results mean that the requested evidence could not be fully determined. Keep the result state, confidence, freshness, and limitations in downstream decisions.

How is WHOIS Lookup priced?

Pricing depends on the operation and execution mode. Check the endpoint reference for the current credit cost, authentication requirement, and per-item rules.