# 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"
    }
  ],
  ...
}