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.

(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.

Sample Request Live Demo!

domain

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/domain?domain=github.com

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
{
    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

1 2 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.