POST AI agent ready /v1/asn/lookup

ASN Lookup API - Autonomous System Number & RDAP Enrichment

Send an ASN number to retrieve the organization name, country, and RDAP registration data including handle, entity name, type, IP range, registration date, and abuse contact email. If no ASN is provided, the caller's own ASN (from Cloudflare) is used.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/asn/lookup \
  -H "Content-Type: application/json" \
  -d '{"asn":13335}'

When to use this API

Network peering analysis

Look up ASNs to identify which organizations operate specific network ranges. Use this data to evaluate peering partnerships, map interconnection points, and analyze traffic routing paths.

ISP identification for traffic analysis

Enrich IP log data with ASN organization names to identify which ISPs or hosting providers your users connect from. Group traffic by ASN to spot unusual patterns or high-risk hosting providers.

Abuse contact lookup

When you detect abusive traffic from an IP range, look up the ASN to find the abuse contact email. Automate abuse reports by pulling the contact directly from the RDAP record.

Frequently asked questions

What is an ASN?

An Autonomous System Number (ASN) is a unique identifier assigned to a network operator (ISP, hosting provider, or large enterprise). Each ASN controls a set of IP address ranges and announces BGP routes to exchange traffic with other networks.

What happens if I omit the asn parameter?

The endpoint returns data for the ASN associated with your own IP address, as detected by Cloudflare. This is useful for identifying your own ISP or network operator.

Where does the RDAP data come from?

RDAP (Registration Data Access Protocol) data comes from the Regional Internet Registries (ARIN, RIPE, APNIC, LACNIC, AFRINIC). The endpoint queries the appropriate registry based on the ASN range.

Can I look up ASNs for any country?

Yes. ASNs are global. Pass any valid ASN number (1 through 401308) regardless of the country it operates in. The response includes the country of registration.

Is the abuse contact always available?

Most ASN registrations include an abuse contact, but some older or less-maintained records may lack one. The abuse_contact field returns null when no contact is found in the RDAP record.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.