Registration workflows
Check whether a domain is registered or conclusively unregistered before the next step in your workflow.
WHOIS API
Domain registration data.
One JSON API.
Look up domain registration status, with registrar, expiry and nameservers when the registry provides them. Query one domain or process a list asynchronously.
Domain lookup1 Credit per successfully queried domain
TLD coverageFree
Registration detailsSample data · example.com
- Registration
- Registered
- Registrar
- Example Registrar
- Registered on
- Jan 1, 2020
- Expires on
- Jan 1, 2027
- Nameservers
- ns1.example.test
Example values from the published schema, not a live lookup. Registry policies can limit available fields.
Explore the full response
PUT DOMAIN DATA TO WORK
Domain intelligence, where you need it.
Portfolio operations
Retrieve registration and expiry fields when supplied by the authoritative source. Inspect quality warnings for unavailable data.
Batch enrichment
Submit domain lists, follow progress, and read results in input order through the same integration.
UNDERSTAND THE RESULTS
Know what your result includes.
Registry responses vary. Use registration status for your workflow, then inspect warnings before relying on optional fields.
Check your TLD first
Support and temporary availability vary by TLD. Check coverage before submitting your domains.
TLD coverage guideKnow what the data means
Registration status can be conclusive even when registrar, dates or contacts are missing. Read the quality warnings.
Data quality guide- 01
Submit your domains
POST /batches - 02
Check progress
GET /batches/{job_id} - 03
Read the results
GET /batches/{job_id}/results
FOR DOMAIN LISTS
One request to start. Results when ready.
Submit a domain list, follow progress, then read the results in input order. HTTP 202 means accepted; successful domains are charged when the job settles.
Read the batch guideEndpoints and pricing
Check the charging unit for each operation before you call it. The prices below describe this published release.
Release 1.0.0 · 6 endpoints
| Path | Description | Billing |
|---|---|---|
GET/domains/{domain} | Look up domain registration | 1 Credit per successfully queried domain |
GET/tlds | List TLD coverage | Free |
POST/batches | Create a batch lookup | 1 Credit per successfully queried domain |
GET/batches/{job_id} | Get batch progress | Free |
GET/batches/{job_id}/results | Read batch results | Free |
POST/batches/{job_id}:cancel | Cancel a batch lookup | Free |
Your first domain lookup
Create a project API key and run this request from your terminal.
- Create a project key
Choose your organization and project in Console. Keep the issued key in your backend or local environment.
- Check your Credits
For this paid lookup, make sure your organization has eligible Credits and your project has budget available.
- Review the request record
Run the request below. Check the response, then open Console to see its status and any final charge.
Domain lookup1 Credit per successfully queried domain
Requests use https://api.antapi.dev. Set only ANTAPI_KEY privately in your local environment before running the example.
Request · cURL
curl --request GET 'https://api.antapi.dev/whois/v1/domains/example.com' \
--header "Authorization: Bearer $ANTAPI_KEY"Skill access
Install the product Skill independently. It calls this API directly using your project key, Credits and limits. The CLI is an optional alternative.
Look up a domain’s registration and list TLD coverage. Batch commands are not included in this Skill.
Available
Install from the repository
npx skills add xiaopozhu/antapi-skills --skill antapi-whoisRequires Node.js 22.20 or later and npm. Choose your agent when prompted. Private repositories use your configured Git credentials.
WHOIS API questions
How should I interpret registration status?
A conclusive registered or unregistered result is a successful lookup. An unknown or inconclusive result does not establish that a domain is available to register.
Read the guideWhy are some WHOIS fields missing?
Available fields vary by registry, TLD and source. Registrar, expiry, nameservers and contact data may be missing or redacted. Inspect quality warnings before relying on optional fields.
Read the guideCan I look up a list of domains?
Use an asynchronous batch job to submit a domain list, check progress and read results in input order. HTTP 202 confirms acceptance. Final settlement counts successful domains and releases unused Credits reservations.
Read the guidePut domain data to work.
Create an account, issue a key, and make your first request.