Loading
Loading
Query real-time WHOIS records for any AS number. Returns organizational details, CIDR block inventory, BGP peer relationships, and structured RIR contact data — sourced live from all 5 RIRs.
The ASN Lookup API provides a complete network operator profile for any Autonomous System Number — including WHOIS registration, advertised CIDR prefixes, BGP relationships (upstreams, downstreams, peers), structured RIR contact records, and raw WHOIS text. Perfect for network analysis, threat intelligence, and infrastructure profiling.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters.
asnrequiredStringAutonomous System Number with or without 'as'
A successful request returns a 200 OK response with a JSON object containing the ASN data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.
asNumberAS number to query live WHOIS, e.g., 1234, etc.
asNameAS name for the autonomous system
orgNameOrganization name holding the AS number
descriptionDescription of the autonomous system
orgHandleOrganization handle or unique identifier
countryCountry code where the AS is registered
domainDomain associated with the AS
websiteWebsite URL of the organization
allocationStatusAllocation status of the AS number (e.g., allocated, assigned)
numOfIPv4RoutesNumber of IPv4 routes announced by this AS
numOfIPv6RoutesNumber of IPv6 routes announced by this AS
whoisHostWHOIS host server used to query the AS number
dateAllocatedDate when the AS was allocated in yyyy-MM-dd format (can be empty string)
typeType of the organization (e.g., BUSINESS, ISP)
routeObjectsList of route objects announced by this AS
whoisResponseRaw WHOIS response from the WHOIS server
downstreamsList of downstream autonomous systems
parsedWhoisResponseParsed and structured WHOIS response data
upstreamsList of upstream autonomous systems
peersList of peer autonomous systems
contactsContact information for the AS
legacyRoutesList of legacy routes if any
Each routeObjects item contains the following fields:
routeIP route in CIDR notation
originOrigin AS number for the route
originNameName of the origin AS
ispInternet Service Provider name
numberOfIpsNumber of IP addresses in the route
Each ASInfo object contains the following fields:
asNumberAS number (e.g., AS1759)
descriptionDescription of the AS
countryCountry code for the AS
Each contacts object contains the following fields:
emailContactsList of email contacts associated with the AS
abuseContactsList of abuse contact emails
Each parsedWhoisResponse object contains the following fields:
statusStatus of the WHOIS query parsing
whois_serverWHOIS server used for the query
aut_numsList of autonomous number objects
organizationOrganization information
technical_contactsList of technical contacts
abuse_contactsList of abuse contacts
Each organization object contains the following fields:
handleOrganization handle or identifier
nameOrganization name
addressOrganization address components
streetStreet address from the address
cityCity from the address
stateState or province from the address
zip_codeZIP/postal code
countryCountry information
date_createdOrganization creation date in yyyy-MM-dd format
date_updatedLast update date in yyyy-MM-dd format
sourceSource URL for the organization data
addressCountryCountry code from address
Each contact object contains the following fields:
handleContact handle or identifier
nameContact name
emailContact email addresses
phoneContact phone numbers
sourceSource URL for the contact data
Each AutNum object contains the following fields:
aut_numAutonomous System (AS) number
as_handleHandle (unique ID) of this aut-num in WHOIS data
as_nameAS name for the network handling this network
tech_contactsAll handles (unique IDs) of tech persons or roles in WHOIS data
abuse_contactsAll handles (unique IDs) of persons or roles, managing abuse to this aut-num, in WHOIS data
date_createdThis object's registration date, parsed in yyyy-MM-dd format
date_updatedThis object's last update date, parsed in yyyy-MM-dd format
sourceWHOIS data source of this object
Each object within the lists of administrative contacts, technical contacts, and abuse contacts comprises the following fields:
handleHandle or unique identifier of this person or role object in WHOIS data
nameName of the person or role
emailContact email addresses
phoneContact phone numbers
sourceSource URL for the contact data
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Invalid ASN parameter.
Service is unavailable.
Request is timed-out.