pricing background

ASN WHOIS API Documentation

ASN Lookup

The ASN WHOIS API provides detailed information about Autonomous System Numbers (ASNs), including the AS number, name, organization details, country, domain, allocation status, and associated IPv4 and IPv6 routes. It also returns upstream and downstream providers, peers, administrative and technical contacts, abuse contacts, and raw WHOIS data, all available in JSON or XML format.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • asn
    The ASN number with or without 'as' for requested whois. (e.g. as1009 or 1009)
Optional
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
  • 206  Partial response, as an error occurred while processing the request.
Failure Codes
  • 400  Request-param 'asn' (******) is not valid.
  • 400  Request-param 'format' (<format>) is not valid. Supported formats are json, xml.
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 408  Unable to fetch whois data. Please try again.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.