RIS Peerings

This data call returns routes for advertisements of a given IP resource, or that are originated from a given ASN, as seen by the RIPE NCC route collectors.

Historical lookups are supported - a query has to be aligned to the times (00:00, 08:00 and 16:00 UTC) when RIS data has been collected. By default, the data call returns the latest data. 

https://stat.ripe.net/data/ris-peerings/data.<format>?<parameters>

e.g. https://stat.ripe.net/data/ris-peerings/data.json?resource=140.78.0.0/16

Parameters

Key Value Info Required
resource Prefix - YES
query_time ISO8601 or Unix timestamp Defines the time of the lookup. This value will be automatically aligned to a RIS colletion time. No - by default it will return the latest available data point (either 00:00, 08:00 or 16:00 UTC)

Output

Data

Key Info
peerings A list of ASNs grouped by the RIPE NCC Routing Information Service probe they were seen by. Each group item has the following structure:

probe A RIPE NCC Routing Information Service probe. For each probe the following details are provided:

city / country The probe's human readable location.
longitude / latitude Coordinates of the probe's location.
name ID of the probe.
ixp Name of the internet exchange hosting the probe.
ipv4_peer_count / ipv6_peer_count Number of IPv4 or IPv6 peers with this probe.
peers A list of peers of the route collector probe. For each peer the following details are provided:

asn Autonomous System Number of the peer.
ip IP address of the peer.
ip_version IP version (4 or 6) of the peering IP.
table_version IP family (4 or 6) of the prefix table being passed by the peer. For ASn queries, if the peer announces both IPv4 and IPv6 tables, two separate entries will be present in this peer list.
prefix_count Number of prefixes of the family specified in table_version, announced in this peering session.
routes List of AS-paths (of the table_version family) routes related to the queried prefix/ASn, as passed by the peer.
resource The resource this query based on.
query_starttime/query_endtime The time period the query covers. In the upcoming version 2 this will change to just "query_time".

Example

"data": {
        "peerings": [
            {
                "peers": [
                    {
                        "asn": 50300, 
                        "ip": "176.12.110.8", 
                        "ip_version": "4", 
                        "prefix_count": 432971, 
                        "routes": [
                            {
                                "as_path": [
                                    50300, 
                                    5580, 
                                    2852, 
                                    1853, 
                                    1205
                                ]
                            }
                        ]
                    }, 
                    ... 
                    {
                        "asn": 29049, 
                        "ip": "2a01:6480::1", 
                        "ip_version": "6", 
                        "prefix_count": 9930, 
                        "routes": []
                    }
                ], 
                "probe": {
                    "city": "Amsterdam", 
                    "country": "Netherlands", 
                    "ipv4_peer_count": 22, 
                    "ipv6_peer_count": 10, 
                    "ixp": "RIPE-NCC Multihop", 
                    "latitude": 55.656500000000001, 
                    "longitude": 5.0095299999999998, 
                    "name": "RRC00"
                }
            }, 
            ...
            {
                "peers": [
                    {
                        "asn": 16735, 
                        "ip": "187.16.216.24", 
                        "ip_version": "4", 
                        "prefix_count": 420776, 
                        "routes": [
                            {
                                "as_path": [
                                    16735, 
                                    1239, 
                                    3356, 
                                    1853, 
                                    1205
                                ]
                            }
                        ]
                    }, 
                    ... 
                    {
                        "asn": 0, 
                        "ip": "187.16.216.75", 
                        "ip_version": "4", 
                        "prefix_count": 1, 
                        "routes": []
                    }
                ], 
                "probe": {
                    "city": "Sao Paulo", 
                    "country": "Brazil", 
                    "ipv4_peer_count": 13, 
                    "ipv6_peer_count": 8, 
                    "ixp": "PTTMetro", 
                    "latitude": -23.600200000000001, 
                    "longitude": -46.694699999999997, 
                    "name": "RRC15"
                }
            }
        ], 
        "query_endtime": "2012-08-09T08:09:00", 
        "query_starttime": "2012-08-07T08:09:00", 
        "resource": "140.78.0.0/16"
    },

deprecated - 0.4

Difference to 1.*: "resource" field for AS queries is with the "AS" prefix

upcoming - 2.0

Difference to 1.*: query_starttime and query_endtime will be replace by just query_time in the output