# ASN Endpoint

Retrieves information for a specific ASN (autonomous system number).

Request Method: GET
Request URL: https://api.ipbase.com/v2/asns

# Request Parameters

Parameter Type Mandatory Description
apikey string Your API Key
asn string ️️ ️ ️ ️ ️ ️ The ASN you want to query

# Sample Response

{
    "data": {
        "asn": "AS13335",
        "organization": "Cloudflare, Inc.",
        "domain": "cloudflare.com",
        "country": "AU",
        "isp": "APNIC Research and Development",
        "ip_count": 512,
        "ranges_count": 2,
        "ranges": [
            {
                "subnet": "1.0.0.0/24",
                "company": "APNIC Research and Development",
                "ip_count": 256,
                "country": "AU"
            },
            {
                "subnet": "1.1.1.0/24",
                "company": "APNIC Research and Development",
                "ip_count": 256,
                "country": "AU"
            }
        ]
    }
}

# Response structure

Our /asns endpoint offers the following information:

# data

{
  "data": {
    "asn": "AS13335",
    "organization": "Cloudflare, Inc.",
    "domain": "cloudflare.com",
    "country": "AU",
    "isp": "APNIC Research and Development",
    "ip_count": 512,
    "ranges_count": 2,
    "ranges": [{...}]
  }
}

Available in: all plans

Name Type Description
asn integer The requested ASN
organization string ️The organization which owns the ASN
domain string The domain of the organization
country string The ISO 3166-1 alpha-2 country code of the owner of the ASN
isp string ️The ISP which the ASn belongs to
ip_count integer ️The total count of IPs owned by this ASN
ranges_count integer ️The total count of subnet ranges owned by this ASN
ranges array<object> An array of the ranges owned by this ASN (see below)

# ranges

Type: array<object>

{
  ...
  "ranges": [
    {
      "subnet": "1.0.0.0/24",
      "company": "APNIC Research and Development",
      "ip_count": 256,
      "country": "AU"
    },
    {
      "subnet": "1.1.1.0/24",
      "company": "APNIC Research and Development",
      "ip_count": 256,
      "country": "AU"
    }
  ],
  ...
}
Name Type Description
subnet string The subnet in CIDR notation
company string ️The company name owning this subnet
ip_count string Count of the IPs contained in this subnet
country string The ISO 3166-1 alpha-2 country code for the location of the subnet