API docs

Making requests

GEThttps://ip-netblocks-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&ip=8.8.8.8
GEThttps://ip-netblocks-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&ip=8.8.8.8&mask=16
GEThttps://ip-netblocks-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&org=facebook,netherlands
GEThttps://ip-netblocks-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&asn=2544

It takes up to 2 minutes to activate your account after Sign Up.

Input parameters: required

apiKey
Get your personal API KEY on My products page.
ip
Required one of the following input fields: ip, org, asn. Get ranges by IP. IPv4 address.
org
Required one of the following input fields: ip, org, asn. Find IP Netblocks which have all of the specified search terms in their Netblock Name (netname) or Organisation Name (org.name) fields. The search string could be one search term or a list of comma-separated search terms. Maximum 10 terms are allowed. Search terms are the full words only. Terms shorter than 3 symbols or consists of digits only are ignored.
asn
Required one of the following input fields: ip, org, asn. Get ranges by ASN (Autonomous System Number).

Input parameters: optional

mask
Optional for ip parameter only. Get ranges by CIDR.

Acceptable values: 16 - 32

Default: 32
limit
Max count of returned records.

Acceptable values: 100 - 10000

Default: 100
outputFormat
Response output format.

Acceptable values: JSON | XML

Default: JSON

Free access

After Sign Up you automatically get a free subscription plan limited to 1000 queries.

Sample output

JSON
XML
                            [
  {
    "inetnum": "110.170.64.0 - 110.170.127.255",
    "inetnumFirst": 1856651264,
    "inetnumLast": 1856667647,
    "as": {
      "asn": 7470,
      "name": "TRUE INTERNET",
      "type": "Cable/DSL/ISP",
      "route": "110.170.0.0/17",
      "domain": "http://www.trueinternet.co.th"
    },
    "netname": "TrueCorporate",
    "modified": "2013-08-15T07:05:35Z",
    "country": "TH",
    "city": "",
    "abuseContact": [],
    "adminContact": [
      {
        "id": "TIA6-AP",
        "role": "TRUE IP ADMINISTRATION",
        "email": "ipadmin@trueinternet.co.th",
        "phone": "+662 6200400",
        "country": "TH",
        "city": ""
      }
    ],
    "techContact": [
      {
        "id": "TIA6-AP",
        "role": "TRUE IP ADMINISTRATION",
        "email": "ipadmin@trueinternet.co.th",
        "phone": "+662 6200400",
        "country": "TH",
        "city": ""
      }
    ],
    "org": null,
    "mntBy": [
      {
        "mntner": "MAINT-AP-TRUEINTERNET",
        "email": "atchariya_cha@trueinternet.co.th\nipadmin@trueinternet.co.th"
      }
    ],
    "mntDomains": [],
    "mntLower": [],
    "mntRoutes": [],
    "remarks": ["Please send abuse notification to atchariya_cha@trueinternet.co.th"],
    "source": "APNIC"
  },
  {},
  {}
]
                        
                            <xml>
  <item>
    <inetnum>110.170.64.0 - 110.170.127.255</inetnum>
    <inetnumFirst>1856651264</inetnumFirst>
    <inetnumLast>1856667647</inetnumLast>
    <as>
      <asn>7470</asn>
      <name>TRUE INTERNET</name>
      <type>Cable/DSL/ISP</type>
      <route>110.170.0.0/17</route>
      <domain>http://www.trueinternet.co.th</domain>
    </as>
    <netname>TrueCorporate</netname>
    <modified>2013-08-15T07:05:35Z</modified>
    <country>TH</country>
    <city/>
    <abuseContact/>
    <adminContact>
      <item>
        <id>TIA6-AP</id>
        <role>TRUE IP ADMINISTRATION</role>
        <email>ipadmin@trueinternet.co.th</email>
        <phone>+662 6200400</phone>
        <country>TH</country>
        <city/>
      </item>
    </adminContact>
    <techContact>
      <item>
        <id>TIA6-AP</id>
        <role>TRUE IP ADMINISTRATION</role>
        <email>ipadmin@trueinternet.co.th</email>
        <phone>+662 6200400</phone>
        <country>TH</country>
        <city/>
      </item>
    </techContact>
    <org/>
    <mntBy>
      <item>
        <mntner>MAINT-AP-TRUEINTERNET</mntner>
        <email>atchariya_cha@trueinternet.co.th
ipadmin@trueinternet.co.th</email>
      </item>
    </mntBy>
    <mntDomains/>
    <mntLower/>
    <mntRoutes/>
    <remarks>
      <remark>Please send abuse notification to atchariya_cha@trueinternet.co.th</remark>
    </remarks>
    <source>APNIC</source>
  </item>
  <item>...</item>
  <item>...</item>
</xml>
                        
inetnum
e.g. "0.0.0.0 - 255.255.255.255"
inetnumFirst
first IP as integer value, e.g. "134744072" (which is "8.8.8.8: in IP notation)
inetnumLast
last IP as integer value
as {}
Autonomous System – is null when the data is missing
as.asn
Autonomous System Number
as.name
Autonomous System Name
as.type
Autonomous System type, one of the following: "Cable/DSL/ISP", "Content", "Educational/Research", "Enterprise", "Non-Profit", "Not Disclosed", "NSP", "Route Server". Empty when unknown.
as.route
Autonomous System Route
as.domain
Autonomous System Website's URL
netname
name of the IPs range
modified
when the IP Netblock was modified the last time, accordingly to the information provided by the registry. Format: "2018-05-25T10:20:58Z".
country
2 chars' country code
city
name of city
abuseContact [ {} ]
list of administrative contacts
adminContact [ {} ]
list of administrative contacts
techContact [ {} ]
list of technical contacts
abuseContact[k].id
-
abuseContact[k].person
name of the contact person
abuseContact[k].role
role of the contact person
abuseContact[k].phone
-
abuseContact[k].email
-
abuseContact[k].country
-
abuseContact[k].city
-
org {}
organisation registered the range
org.id
-
org.name
-
org.phone
-
org.email
-
org.country
-
org.city
-
mntBy [ {} ]
list of maintainers who are able to update the IPs range
mntBy[k].id
-
mntBy[k].email
-
mntDomains []
list of domains' maintainers
mntLower []
list of maintainers who are able to change sub ranges
mntRoutes []
list of maintainers of routing info
remarks []
remarks and comments associated with the IP Netblock
source
source of range

Account balance information

GEThttps://user.whoisxmlapi.com/service/account-balance?apiKey=YOUR_API_KEY
apiKey
Required. Get your personal API KEY on My products page.
productId
Optional. A list of the products' IDs can be found in the response.

- You can always check your account balance on the My products page. - Note that the following products use the same WHOIS credits: WHOIS API, Bulk WHOIS API, Domain Availability API. - Note that the following products use the same Domain Research Suite credits: Brand Alert API, Registrant Alert API, Reverse WHOIS API, WHOIS History API, Reverse IP/DNS API, Reverse MX API, Reverse NS API.
Try our handy IP Netblocks API free of charge
Get started
Have questions?

We work hard to improve our services for you. As part of that, we welcome your feedback, questions and suggestions. Please let us know your thoughts and feelings, and any way in which you think we can improve our product.

For a quick response, please select the request type that best suits your needs. For more info regarding the request types, see the Contact us page.

Or shoot us an email to