RIS Peerings

---

This endpoint 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 endpoint returns the latest data.

GET /data/ris-peerings/data.json?resource=140.78.0.0/16

Try it

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 collection time.	No - by default it will return the latest available data point (either 00:00, 08:00 or 16:00 UTC)

Data Output

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".

Code Examples

cURL

curl --location --request GET "https://stat.ripe.net/data/ris-peerings/data.json?resource=140.78.0.0/16"

JS

const requestOptions = {
	method: 'GET',
};

fetch("https://stat.ripe.net/data/ris-peerings/data.json?resource=140.78.0.0/16", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));

Available versions for this endpoint:

2.1

1.3 (current)