Available in plans >= medium

ASN Endpoint

Retrieves the information about the provided ASN.


GET/v2/asns

ASN Information

This asn endpoint returns information any specified ASN.

Required attributes

  • Name
    asn
    Type
    string
    Description

    The ASN you want to query

Reponse Structure

Our /asns endpoint offers the following information:

Request

GET
/v2/asns
curl -G https://api.ipbase.com/v2/asns?asn=AS13335 \
    -H "apikey: YOUR-API-KEY"

Full 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"
            }
        ]
    }
}

data   Response Properties

Available in all plans
  • Name
    asn
    Type
    integer
    Description

    The requested ASN

  • Name
    organization
    Type
    string
    Description

    ️️The organization which owns the ASN

  • Name
    domain
    Type
    string
    Description

    The domain of the organization

  • Name
    country
    Type
    string
    Description

    The ISO 3166-1 alpha-2 country code of the owner of the ASN

  • Name
    isp
    Type
    string
    Description

    ️ The ISP which the ASN belongs to

  • Name
    ip_count
    Type
    integer
    Description

    ️The total count of IPs owned by this ASN

  • Name
    ranges_count
    Type
    integer
    Description

    ️The total count of subnet ranges owned by this ASN

  • Name
    ranges
    Type
    array<object>
    Description

    An array of the ranges owned by this ASN (see below)

{
    "data": {
        "ip": "1.1.1.1",
        "hostname": "one.one.one.one",
        "type": "v4",
        ...
    }
}

ranges   Response Properties

Available in all plans
  • Name
    subnet
    Type
    string
    Description

    The subnet in CIDR notation

  • Name
    company
    Type
    string
    Description

    The company name owning this subnet

  • Name
    ip_count
    Type
    string
    Description

    Count of the IPs contained in this subnet

  • Name
    country
    Type
    string
    Description

    The ISO 3166-1 alpha-2 country code for the location of the subnet

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