Radar Autonomous Systems

List autonomous systems

GET /radar/entities/asns

Retrieves a list of autonomous systems.

Responses

200 Successful response.

Data is at body["result"]

{
  "asns": [
    {
      "aka": "*string*",
      "asn": "*integer*",
      "country": "*string*",
      "countryName": "*string*",
      "name": "*string*",
      "orgName": "*string*",
      "website": "*string*"
    }
  ]
}

400 Bad request.

{
  "errors": [
    {
      "message": "*string*"
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Get AS details by IP address

GET /radar/entities/asns/ip

Retrieves the requested autonomous system information based on IP address. Population estimates come from APNIC (refer to https://labs.apnic.net/?p=526).

Responses

200 Successful response.

Data is at body["result"]

{
  "asn": {
    "aka": "*string*",
    "asn": "*integer*",
    "country": "*string*",
    "countryName": "*string*",
    "estimatedUsers": {
      "estimatedUsers": "*integer*",
      "locations": [
        {
          "estimatedUsers": "*integer*",
          "locationAlpha2": "*string*",
          "locationName": "*string*"
        }
      ]
    },
    "name": "*string*",
    "orgName": "*string*",
    "related": [
      {
        "aka": "*string*",
        "asn": "*integer*",
        "estimatedUsers": "*integer*",
        "name": "*string*"
      }
    ],
    "source": "*string*",
    "website": "*string*"
  }
}

404 Not found.

{
  "error": "*string*"
}

Get AS details by ASN

GET /radar/entities/asns/{asn}

Retrieves the requested autonomous system information. (A confidence level below 5 indicates a low level of confidence in the traffic data - normally this happens because Cloudflare has a small amount of traffic from/to this AS). Population estimates come from APNIC (refer to https://labs.apnic.net/?p=526).

Responses

200 Successful response.

Data is at body["result"]

{
  "asn": {
    "aka": "*string*",
    "asn": "*integer*",
    "confidenceLevel": "*integer*",
    "country": "*string*",
    "countryName": "*string*",
    "estimatedUsers": {
      "estimatedUsers": "*integer*",
      "locations": [
        {
          "estimatedUsers": "*integer*",
          "locationAlpha2": "*string*",
          "locationName": "*string*"
        }
      ]
    },
    "name": "*string*",
    "orgName": "*string*",
    "related": [
      {
        "aka": "*string*",
        "asn": "*integer*",
        "estimatedUsers": "*integer*",
        "name": "*string*"
      }
    ],
    "source": "*string*",
    "website": "*string*"
  }
}

404 Not found.

{
  "error": "*string*"
}

Get IRR AS-SETs that an AS is a member of

GET /radar/entities/asns/{asn}/as_set

Retrieves Internet Routing Registry AS-SETs that an AS is a member of.

Responses

200 Successful response.

Data is at body["result"]

{
  "as_sets": [
    {
      "as_members_count": "*integer*",
      "as_set_members_count": "*integer*",
      "as_set_upstreams_count": "*integer*",
      "asn_cone_size": "*integer*",
      "hierarchical_asn": "*integer*",
      "inferred_asn": "*integer*",
      "irr_sources": [
        "*string*"
      ],
      "name": "*string*",
      "peeringdb_asn": "*integer*"
    }
  ],
  "paths": [
    [
      "*string*"
    ]
  ]
}

400 Bad request.

{
  "errors": [
    {
      "message": "*string*"
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Get AS-level relationships by ASN

GET /radar/entities/asns/{asn}/rel

Retrieves AS-level relationship for given networks.

Responses

200 Successful response.

Data is at body["result"]

{
  "meta": {
    "data_time": "*string*",
    "query_time": "*string*",
    "total_peers": "*integer*"
  },
  "rels": [
    {
      "asn1": "*integer*",
      "asn1_country": "*string*",
      "asn1_name": "*string*",
      "asn2": "*integer*",
      "asn2_country": "*string*",
      "asn2_name": "*string*",
      "rel": "*string*"
    }
  ]
}

400 Bad request.

{
  "errors": [
    {
      "message": "*string*"
    }
  ],
  "result": {},
  "success": "*boolean*"
}