API Documentation

The DomainInventory API gives you programmatic access to 20 domain-data endpoints — DNS, WHOIS, SSL, hosting, availability, pricing and more — so you can display our data on your own site or in your apps.

Getting started

Create an API key in your workspace under Settings → API, then send it as a Bearer token on every request. Keys look like di_live_….

curl "https://domaininventory.com/api/v1/dns?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

You can also pass the key as an X-API-Key header, or as an ?api_key= query parameter (handy for quick tests).

Responses

Every response is JSON with an ok boolean. On success the payload is under data; on failure there is an error string.

{
  "ok": true,
  "endpoint": "dns",
  "data": {
    "host": "example.com",
    "results": [
      { "type": "A", "records": [{ "ttl": 300, "data": "93.184.216.34" }] }
    ]
  }
}

{ "ok": false, "error": "Invalid or revoked API key." }

Authentication & rate limits

Auth	Authorization: Bearer di_live_… (or X-API-Key header, or ?api_key=)
Rate limit	60 requests per minute per key
Limit headers	X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Over limit	HTTP 429 with a retry hint
Bad / missing key	HTTP 401
CORS	Enabled — you can call the API from browser JavaScript

Endpoints (20)

DNS & Email

GET/api/v1/dns

DNS Lookup

All DNS records (A, AAAA, MX, NS, TXT, CNAME, SOA, CAA) for a domain.

Param	Req?	Description
domain	required	Domain to look up.

curl "https://domaininventory.com/api/v1/dns?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/dns-propagation

DNS Propagation

A record checked across 8 global public resolvers.

Param	Req?	Description
domain	required	Domain to check.
type	optional	Record type (A, AAAA, CNAME, MX, NS, TXT). Default A.

curl "https://domaininventory.com/api/v1/dns-propagation?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/email-security

Email Security

MX, SPF, DMARC & DKIM audit with a deliverability grade.

Param	Req?	Description
domain	required	Domain to audit.

curl "https://domaininventory.com/api/v1/email-security?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/dnssec

DNSSEC

DNSSEC signing status (DS / DNSKEY).

Param	Req?	Description
domain	required	Domain to check.

curl "https://domaininventory.com/api/v1/dnssec?domain=cloudflare.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/reverse-dns

Reverse DNS

PTR for an IP, or A/AAAA for a hostname.

Param	Req?	Description
query	required	IP address or hostname.

curl "https://domaininventory.com/api/v1/reverse-dns?query=8.8.8.8" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/reverse-ip

Reverse IP

Other domains hosted on the same IP.

Param	Req?	Description
query	required	IP address or domain.

curl "https://domaininventory.com/api/v1/reverse-ip?query=github.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/hosting

Hosting IP

Server IPs, hosting provider, location, reverse DNS and CDN.

Param	Req?	Description
domain	required	Domain to inspect.

curl "https://domaininventory.com/api/v1/hosting?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/ip-geo

IP Geolocation

Country, city, ISP and ASN for an IP or domain.

Param	Req?	Description
query	required	IP address or domain.

curl "https://domaininventory.com/api/v1/ip-geo?query=1.1.1.1" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

WHOIS & Ownership

GET/api/v1/whois

WHOIS Lookup

Registrar, dates, nameservers and status via RDAP/WHOIS.

Param	Req?	Description
domain	required	Domain to look up.

curl "https://domaininventory.com/api/v1/whois?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/whois-history

WHOIS History

Current record + certificate-based infrastructure timeline (full history needs a provider key).

Param	Req?	Description
domain	required	Domain to trace.

curl "https://domaininventory.com/api/v1/whois-history?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

Availability

POST/api/v1/availability

Availability (bulk)

Registered vs available for up to 100 domains.

Param	Req?	Description
domains	required	JSON array of up to 100 domains.

curl -X POST "https://domaininventory.com/api/v1/availability" \
  -H "Authorization: Bearer di_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["example.com","free-xyz.dev"]}'

GET/api/v1/tld-availability

TLD Availability

A name checked across 50+ popular TLDs.

Param	Req?	Description
name	required	Name (without extension).

curl "https://domaininventory.com/api/v1/tld-availability?name=yourbrand" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

Security

GET/api/v1/ssl

SSL/TLS Check

Certificate issuer, validity, days remaining, SANs and TLS version.

Param	Req?	Description
domain	required	Host to inspect over 443.

curl "https://domaininventory.com/api/v1/ssl?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/ct-logs

Certificate Transparency

Certificates issued for a domain (mode=certs) or its subdomains (mode=subdomains).

Param	Req?	Description
domain	required	Domain to query.
mode	optional	`certs` (default) or `subdomains`.

curl "https://domaininventory.com/api/v1/ct-logs?domain=example.com&mode=subdomains" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/blacklist

DNSBL Blacklist

Blacklist status of an IP/domain across 8 DNSBLs.

Param	Req?	Description
query	required	IP address or domain.

curl "https://domaininventory.com/api/v1/blacklist?query=8.8.8.8" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

Website

GET/api/v1/wayback

Website History

First/last Wayback snapshot and per-year capture counts.

Param	Req?	Description
domain	required	Domain to check.

curl "https://domaininventory.com/api/v1/wayback?domain=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/headers

HTTP Headers

Response headers, status and redirect chain for a URL.

Param	Req?	Description
url	required	URL or domain.

curl "https://domaininventory.com/api/v1/headers?url=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

GET/api/v1/page

Page Analysis

Title, meta, Open Graph, detected technologies and parked-domain signals.

Param	Req?	Description
url	required	URL or domain.

curl "https://domaininventory.com/api/v1/page?url=example.com" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

Pricing

GET/api/v1/tld-price

TLD Pricing

Live registration / renewal / transfer prices for every TLD.

No parameters.

curl "https://domaininventory.com/api/v1/tld-price" \
  -H "Authorization: Bearer di_live_YOUR_KEY"

POST/api/v1/domain-price

Domain Price (bulk)

Registration/renewal/transfer prices for up to 200 domains.

Param	Req?	Description
domains	required	JSON array of up to 200 domains.

curl -X POST "https://domaininventory.com/api/v1/domain-price" \
  -H "Authorization: Bearer di_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["example.com","test.io"]}'

Ready to build? Create your API key and start making requests. Questions or need a higher rate limit? Get in touch and we’ll help.