NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Domain API

The Domain API checks domain availability and returns registration lifecycle data (creation, expiration, and update dates, registrar, and status codes) plus email and hosting intelligence — MX/mail provider, free-email and disposable detection, parking status, and hosting network — for any given domain.

For detailed domain registration information from the WHOIS protocol, check out our Whois API instead.

Online
(4.6)

From 7,638 users

4,400+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
332ms373ms432ms628ms1047ms

Didn't find what you were looking for? Suggest an improvement

https://api.api-ninjas.com/v1/domain

Returns availability, registration lifecycle, and email/hosting intelligence for a given domain name.

Parameters

  • domain  required

    Valid domain to check (e.g. github.com). For top-level domains other than .com, a premium subscription is required.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • domain

    The domain name that was checked.

  • available

    Whether the domain is available for registration (true or false).

  • creation_date

    Unix timestamp of when the domain was registered.

  • expiration_date

    Unix timestamp of when the domain registration expires.

  • age_days

    Age of the domain in days, derived from creation_date. A commonly used trust/risk signal.

  • registrar

    Name of the registrar the domain is registered with.

  • updated_date  Premium only

    Unix timestamp of when the domain record was last updated.

  • domain_status  Premium only

    Array of EPP status codes translated to snake_case strings (e.g. client_transfer_prohibited, pending_delete, redemption_period). Indicates registrar/registry locks and the domain's lifecycle state.

  • has_mx  Premium only

    Whether the domain has any MX (mail exchange) records, i.e. whether it is configured to receive email.

  • is_free_email_provider  Premium only

    Whether the domain is a known free or webmail provider (e.g. gmail.com, outlook.com).

  • risky_tld  Premium only

    Whether the domain's top-level domain is one disproportionately associated with spam or abuse.

  • is_disposable_email_domain  Business tier and above

    Whether the domain is a known disposable / temporary email provider. See our Disposable Email Checker API.

  • is_custom_domain  Business tier and above

    Whether the domain looks like a custom/business email domain: it accepts mail and is not a free, webmail, or disposable provider.

  • mx_provider  Business tier and above

    The email provider serving the domain, inferred from its MX records (e.g. Google Workspace, Microsoft 365), or null if not recognized.

  • is_parked  Business tier and above

    Whether the domain appears to be parked or listed for sale, inferred from its nameservers.

  • ip  Business tier and above

    The IPv4 address the domain currently resolves to.

  • hosting_provider  Business tier and above

    The network / hosting provider (autonomous system) the resolved IP belongs to.

  • country  Business tier and above

    Two-letter country code where the resolved IP is registered.

Live Demo

Live demo · no API key required
Query parameters
domain

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/domain?domain=github.com
Sample response
{
"domain": "github.com",
"available": false,
"creation_date": 1191954050,
"expiration_date": 1791570050,
"updated_date": 1725700593,
"registrar": "markmonitor, inc.",
"domain_status": [
"client_delete_prohibited",
"client_transfer_prohibited",
"client_update_prohibited"
],
"age_days": 6882,
"has_mx": true,
"is_free_email_provider": false,
"risky_tld": false,
"is_disposable_email_domain": false,
"mx_provider": "Microsoft 365",
"is_parked": false,
"ip": "140.82.116.4",
"hosting_provider": "GitHub, Inc.",
"country": "US",
"is_custom_domain": true
}

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/domain?domain=github.com" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Domain API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Send a GET request to the /v1/domain endpoint with the required domain parameter (e.g. domain=example.com). Note that checking top-level domains other than .com requires a premium subscription.
  • The response returns the domain that was checked and a boolean available field indicating whether it can be registered; when available is false, it also includes the creation_date (a Unix timestamp) and the registrar name. See the error codes page for unsuccessful requests.
  • It is ideal for building domain name search tools, registration/availability checkers, and brand-monitoring dashboards that need a quick yes/no availability answer plus basic registration details. For full WHOIS registration records, use the Whois API, and explore related tools like the DNS Lookup API and URL Lookup API.
  • The Domain API focuses on availability status and a few basic registration fields like creation_date and registrar, whereas the Whois API returns the detailed registration record from the WHOIS protocol. Browse all available endpoints on our APIs page.

Explore API integration use cases for recommended APIs and workflow examples.