CTRL+K

ASN Lookup API

GET

https://api.apifreaks.com/v1.0/asn/whois/live

Sample Responses

400

LANGUAGE

Python

PHP

Java

Node

Ruby


$ pip install requests

RESPONSE

Click Test it to start the request and see the response here!

API Response

Field	Type	Requirement	Description
asNumber	String	Mandatory	AS number to query live WHOIS, e.g., 1234, etc.
asName	String	Mandatory	AS name for the autonomous system
orgName	String	Mandatory	Organization name holding the AS number
description	String	Optional	Description of the autonomous system
orgHandle	String	Mandatory	Organization handle or unique identifier
country	String	Mandatory	Country code where the AS is registered
domain	String	Optional	Domain associated with the AS
website	String	Optional	Website URL of the organization
allocationStatus	String	Mandatory	Allocation status of the AS number (e.g., allocated, assigned)
numOfIPv4Routes	String	Mandatory	Number of IPv4 routes announced by this AS
numOfIPv6Routes	String	Mandatory	Number of IPv6 routes announced by this AS
whoisHost	String	Mandatory	WHOIS host server used to query the AS number
dateAllocated	String	Optional	Date when the AS was allocated in yyyy-MM-dd format (can be empty string)
type	String	Mandatory	Type of the organization (e.g., BUSINESS, ISP)
routeObjects	Array	Mandatory	List of route objects announced by this AS
whoisResponse	String	Mandatory	Raw WHOIS response from the WHOIS server
downstreams	Array<ASInfo>	Mandatory	List of downstream autonomous systems
parsedWhoisResponse	Object	Mandatory	Parsed and structured WHOIS response data
upstreams	Array<ASInfo>	Mandatory	List of upstream autonomous systems
peers	Array<ASInfo>	Mandatory	List of peer autonomous systems
contacts	Object	Mandatory	Contact information for the AS
legacyRoutes	Array<String>	Mandatory	List of legacy routes if any

routeObject contains the following fields:

Field	Type	Requirement	Description
route	String	Mandatory	IP route in CIDR notation
origin	String	Mandatory	Origin AS number for the route
originName	String	Mandatory	Name of the origin AS
isp	String	Mandatory	Internet Service Provider name
numberOfIps	Number	Mandatory	Number of IP addresses in the route

ASInfo contains the following fields:

Field	Type	Requirement	Description
asNumber	String	Mandatory	AS number (e.g., AS1759)
description	String	Mandatory	Description of the AS
country	String	Mandatory	Country code for the AS

contacts contains the following fields:

Field	Type	Requirement	Description
emailContacts	Array<String>	Mandatory	List of email contacts associated with the AS
abuseContacts	Array<String>	Mandatory	List of abuse contact emails

parsedWhoisResponse contains the following fields:

Field	Type	Requirement	Description
status	Boolean	Mandatory	Status of the WHOIS query parsing
whois_server	String	Mandatory	WHOIS server used for the query
aut_nums	Array<AutNum>	Mandatory	List of autonomous number objects
organization	Object	Optional	Organization information
technical_contacts	Array<Contact>	Optional	List of technical contacts
abuse_contacts	Array<Contact>	Optional	List of abuse contacts

organization contains following fields:

Field	Type	Requirement	Description
handle	String	Mandatory	Organization handle or identifier
name	String	Mandatory	Organization name
address	Array<String>	Mandatory	Organization address components
street	String	Optional	Street address from the address
city	String	Optional	City from the address
state	String	Optional	State or province from the address
zip_code	String	Optional	ZIP/postal code
country	Array<String>	Optional	Country information
date_created	String	Optional	Organization creation date in yyyy-MM-dd format
date_updated	String	Optional	Last update date in yyyy-MM-dd format
source	String	Optional	Source URL for the organization data
addressCountry	String	Optional	Country code from address

contact contains following fields:

Field	Type	Requirement	Description
handle	String	Mandatory	Contact handle or identifier
name	String	Mandatory	Contact name
email	Array<String>	Mandatory	Contact email addresses
phone	Array<String>	Optional	Contact phone numbers
source	String	Optional	Source URL for the contact data

AutNum contains following fields:

Field	Type	Requirement	Description
aut_num	String	Mandatory	Autonomous System (AS) number
as_handle	String	Mandatory	Handle (unique ID) of this aut-num in WHOIS data
as_name	String	Mandatory	AS name for the network handling this network
tech_contacts	Array<String>	Mandatory	All handles (unique IDs) of tech persons or roles in WHOIS data
abuse_contacts	Array<String>	Optional	All handles (unique IDs) of persons or roles, managing abuse to this aut-num, in WHOIS data
date_created	String	Optional	This object's registration date, parsed in yyyy-MM-dd format
date_updated	String	Mandatory	This object's last update date, parsed in yyyy-MM-dd format
source	String	Mandatory	WHOIS data source of this object

Each object within the lists of administrative contacts, technical contacts, and abuse contacts comprises the following fields:

Field	Type	Requirement	Description
handle	String	Mandatory	Handle or unique identifier of this person or role object in WHOIS data
name	String	Mandatory	Name of the person or role
email	Array<String>	Mandatory	Contact email addresses
phone	Array<String>	Optional	Contact phone numbers
source	String	Optional	Source URL for the contact data