WHOIS API

Getting started

Subscribe, copy your secret key, and run your first WHOIS lookup.

The Syndaq WHOIS API returns registration metadata for a domain. Each lookup includes registrar, creation and expiration dates, domain age in days, status flags, and nameservers.

What you need

  1. A WHOIS plan from the Syndaq API catalog.
  2. A secret key (wh_sec_) from the Syndaq client area after your order is provisioned.

WHOIS lookups are server-side only. Send your secret key from your backend or trusted worker. Do not embed it in client-side code, mobile apps, or public repositories.

Base URL

All WHOIS endpoints are served from:

https://api.syndaq.com/v1/whois/

Quick start

Replace wh_sec_YOUR_SECRET_KEY with the secret shown in Services for your WHOIS subscription.

curl -sS "https://api.syndaq.com/v1/whois/lookup/example.com" \
  -H "Authorization: Bearer wh_sec_YOUR_SECRET_KEY"

You can also pass the domain as a query parameter:

curl -sS "https://api.syndaq.com/v1/whois/lookup?domain=example.com" \
  -H "Authorization: Bearer wh_sec_YOUR_SECRET_KEY"

A successful response includes registrar, created_at, expires_at, domain_age_days, and nameservers.

How lookups work

StepWhat happens
1Authenticate with your secret key.
2Send a domain lookup request to the API.
3Receive JSON with the result fields (including a cached flag when Syndaq already holds a recent result).

Invalid domains return a clear error. Domains that cannot be resolved return a not-found style error without inventing data.

Manage your subscription

Sign in to the Syndaq client area and open Services. Select your WHOIS service to:

  • View usage and remaining monthly quota
  • Copy or rotate your secret key
  • Configure optional IP allowlists for API access

Next steps