The Name Toolkit API makes it easy to integrate domain related information into your app.

Whois API

Which TLDs are supported?

One question we get asked a lot is how many TLDs we support. That's actually a complex question, every TLD has different information or none in some cases, some TLD providers don't provide a whois service at all! Others do but intentionally limit information, so we maintain basic support for the following list:

ac, ad, aero, ae, af, ag, ai, al, am, an, ao, aq, ar, asia, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, biz, bi, bj, bm, bn, bo, br, bs, bt, bv, bw, by, bz, cat, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, com, coop, co.uk, co, cr, cu, cv, cx, cy, cz, de, dj, dk, dm, do, dz, ec, edu, ee, eg, er, es, et, eu, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gov, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, info, in, io, iq, ir, is, it, je, jm, jobs, jo, jp, ke, kg, kh, ki, km, kn, kp, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ly, ma, mc, md, me, mg, mh, mil, mk, ml, mm, mn, mobi, mo, mp, mq, mr, ms, mt, museum, mu, mv, mw, mx, my, mz, name, na, nc, net, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, org, pa, pe, pf, pg, ph, pk, pl, pm, pn, pr, pro, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, sd, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, st, su, sv, sy, sz, tc, td, tel, tf, tg, th, tj, tk, tl, tm, tn, to, tp, travel, tr, tt, tv, tw, tz, ua, ug, uk, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, ye, yt, za, zm, zw

Which fields do you parse?

At the moment we reliably parse dateExpires, and domain status for nearly all supported TLDs. We support much more for the most popular TLDs and we update the API regularly so anything more detailed here will likely age badly. Ideally we'd like to parse everything available for all TLDs but this is a long term goal.

Last 7 days, UTC

Average Latency
194ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Freemium

$0

additional fees may apply

Queries

2,000 / mo.

$0.0100 per extra

Subscribe

basic

$15.00

per month

Queries

25,000 / mo.

$0.0070 per extra

Subscribe

ultra

$150.00

per month

Queries

350,000 / mo.

$0.0030 per extra

Subscribe

Endpoints

HTTP 200 : Alexa Rank Model GET/alexarank
						{
  "popularity_rank": 600444,
  "reach_rank": 596845
}						
Alexa Rank

Test console
Description
Parameter
string

Domain to get Alexa Ranks for
Example: foo.com

domain

Required

HTTP 200 : Whois 1.0 Model GET/v1/whois
						{
  "domain": "mashape.com",
  "technical_contact": "",
  "dateExpires": "2014-02-01",
  "fax": "",
  "raw": "\nWhois Server Version 2.0\n\nDomain names in the .com and .net domains can now be registered\nwith many different competing registrars. Go to http://www.internic.net\nfor detailed information.\n\n   Domain Name: MASHAPE.COM\n   Registrar: DOMAIN.COM, LLC\n   Whois Server: whois.domain.com\n   Referral URL: http://www.domain.com\n   Name Server: NS-1327.AWSDNS-37.ORG\n   Name Server: NS-1784.AWSDNS-31.CO.UK\n   Name Server: NS-27.AWSDNS-03.COM\n   Name Server: NS-986.AWSDNS-59.NET\n   Status: clientTransferProhibited\n   Status: clientUpdateProhibited\n   Updated Date: 10-sep-2012\n   Creation Date: 01-feb-2009\n   Expiration Date: 01-feb-2014\n\n>>> Last update of whois database: Fri, 15 Mar 2013 13:56:27 UTC <<<\n\nNOTICE: The expiration date displayed in this record is the date the \nregistrar's sponsorship of the domain name registration in the registry is \ncurrently set to expire. This date does not necessarily reflect the expiration \ndate of the domain name registrant's agreement with the sponsoring \nregistrar.  Users may consult the sponsoring registrar's Whois database to \nview the registrar's reported date of expiration for this registration.\n\nTERMS OF USE: You are not authorized to access or query our Whois \ndatabase through the use of electronic processes that are high-volume and \nautomated except as reasonably necessary to register domain names or \nmodify existing registrations; the Data in VeriSign Global Registry \nServices' (\"VeriSign\") Whois database is provided by VeriSign for \ninformation purposes only, and to assist persons in obtaining information \nabout or related to a domain name registration record. VeriSign does not \nguarantee its accuracy. By submitting a Whois query, you agree to abide \nby the following terms of use: You agree that you may use this Data only \nfor lawful purposes and that under no circumstances will you use this Data \nto: (1) allow, enable, or otherwise support the transmission of mass \nunsolicited, commercial advertising or solicitations via e-mail, telephone, \nor facsimile; or (2) enable high volume, automated, electronic processes \nthat apply to VeriSign (or its computer systems). The compilation, \nrepackaging, dissemination or other use of this Data is expressly \nprohibited without the prior written consent of VeriSign. You agree not to \nuse electronic processes that are automated and high-volume to access or \nquery the Whois database except as reasonably necessary to register \ndomain names or modify existing registrations. VeriSign reserves the right \nto restrict your access to the Whois database in its sole discretion to ensure \noperational stability.  VeriSign may restrict or terminate your access to the \nWhois database for failure to abide by these terms of use. VeriSign \nreserves the right to modify these terms at any time. \n\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\nRegistrars.\nRegistrant:\n Mashape, Inc.\n 433 Bryant Street\n San Francisco, California 94107\n US\n\n Domain name: MASHAPE.COM\n\n\n Administrative Contact:\n    Palladino, Marco  support@mashape.com\n    433 Bryant Street\n    San Francisco, California 94107\n    US\n    +1.4153613858\n Technical Contact:\n    Palladino, Marco  support@mashape.com\n    433 Bryant Street\n    San Francisco, California 94107\n    US\n    +1.4153613858\n\n\n Registration Service Provider:\n    Domain.com, support@domain-inc.net\n    +1.8004033568\n    This company may be contacted for domain login/passwords,\n    DNS/Nameserver changes, and general domain support questions.\n\n\n Registrar of Record: Domain.com\n Record last updated on 10-Sep-2012.\n Record expires on 01-Feb-2014.\n Record created on 01-Feb-2009.\n\n Domain servers in listed order:\n    NS-27.AWSDNS-03.COM   \n    NS-1784.AWSDNS-31.CO.UK   \n    NS-1327.AWSDNS-37.ORG   \n    NS-986.AWSDNS-59.NET   \n\n\n Domain status: clientTransferProhibited\n                clientUpdateProhibited\n\n\n",
  "administrative_contact": [
    "Palladino, Marco  support@mashape.com",
    "433 Bryant Street",
    "San Francisco, California 94107",
    "US",
    "+1.4153613858",
    "Technical Contact:",
    "Palladino, Marco  support@mashape.com",
    "433 Bryant Street",
    "San Francisco, California 94107",
    "US",
    "+1.4153613858"
  ],
  "address_country": "",
  "checked": "mashape.com",
  "descr": "",
  "email": "",
  "status": "taken",
  "updated": "10-sep-2012",
  "name_server": [
    "NS-1327.AWSDNS-37.ORG",
    "NS-1784.AWSDNS-31.CO.UK",
    "NS-27.AWSDNS-03.COM",
    "NS-986.AWSDNS-59.NET"
  ],
  "phone": "",
  "address": "",
  "referral_domain": "",
  "address_city": "",
  "name": "Registrant obfuscated",
  "created": "01-feb-2009",
  "expiration_date": "01-feb-2014",
  "address_postal_code": "",
  "registrar": "DOMAIN.COM, LLC",
  "referral_url": "www.domain.com"
}						
Whois 1.0

Test console
Description
Parameter
string

Example: mashape.com

q

Required

HTTP 200 : Whois 2.0 Model GET/beta/whois/{domain}
						{
  "available": false,
  "status": "registered",
  "domain": "car.ca",
  "domain_id": null,
  "expiration_date": "2013-07-21 00:00:00 +0200",
  "registrar": {
    "id": "29",
    "name": "Internic.ca Inc.",
    "organization": "Internic.ca Inc.",
    "url": null
  },
  "updated_on": "2011-07-11 00:00:00 +0200",
  "registrant_contacts": [
    {
      "id": null,
      "type": 1,
      "name": "Canadian Association of Radiologists",
      "organization": null,
      "address": null,
      "city": null,
      "zip": null,
      "state": null,
      "country": null,
      "country_code": null,
      "phone": null,
      "fax": null,
      "email": null,
      "url": null,
      "created_on": null,
      "updated_on": null
    }
  ],
  "admin_contacts": [
    {
      "id": null,
      "type": 2,
      "name": "Glenda Cardinal",
      "organization": null,
      "address": "310-377 Dalhousie Street\nOttawa ON K1N1N8 Canada",
      "city": null,
      "zip": null,
      "state": null,
      "country": null,
      "country_code": null,
      "phone": "+1.6138603111",
      "fax": "+1.6138603112",
      "email": "gcardinal@car.ca",
      "url": null,
      "created_on": null,
      "updated_on": null
    }
  ],
  "technical_contacts": [
    {
      "id": null,
      "type": 3,
      "name": "Gary Eikenberry",
      "organization": null,
      "address": "1117 Elmlea Dr.\nGloucester ON K1J6W3 Canada",
      "city": null,
      "zip": null,
      "state": null,
      "country": null,
      "country_code": null,
      "phone": "+1.6137487485",
      "fax": "+1.6137471876",
      "email": "garyeik@ncf.ca",
      "url": null,
      "created_on": null,
      "updated_on": null
    }
  ],
  "nameservers": [
    {
      "name": "cns1.canadianwebhosting.com",
      "ipv4": null,
      "ipv6": null
    },
    {
      "name": "cns2.canadianwebhosting.com",
      "ipv4": null,
      "ipv6": null
    }
  ]
}						
Whois 2.0 (beta)

Warning this API is unstable and may change at short notice


Test console
Description
Parameter
string

Example: car.ca

domain

Required

HTTP 200 : nslookup Model GET/nslookup
						{
  "name": "sinatrarb.com",
  "address": "207.97.227.245"
}						
nslookup

Test console
Description
Parameter
string

Example: sinatrarb.com

q

Required

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like Name Toolkit.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.