Routing History

---

This endpoint shows the history of announcements for prefixes, including the origin ASN and the first hop.

The data comes from the RIS route collectors.

GET /data/routing-history/data.json?resource=AS3333

Try it

Parameters

Key	Value	Info	Required
resource	prefix or ASN	The resource to query. This is a prefix (v4/v6), IP address or AS number.	yes
max_rows	integer	The maximum number of routes to return. This is a soft limit: all recorded routes for each origin ASN are returned, but when the row limit is reached no more origins will be returned.	no (default: 3000)
include_first_hop	boolean	Include the first hop ASN in the route, instead of just the origin ASN.	no (default: false)
normalise_visibility	boolean	Add a visibility field to each timeline indicating the visibility of the route (according to RIS) at that point in time. The visibility is computed as the peers_seeing divided by the number of RIS full table peers at the time.	no (default: false)
min_peers	integer	Minimum number of full-feed RIS peers seeing the route for the segment to be included in the results. Excludes low-visibility/localized announcements.	no (default: 10)
starttime	ISO8601 or Unix timestamp	Defines the starttime for the query	no
endtime	ISO8601 or Unix timestamp	Defines the endtime for the query	no (default: latest time there is BGP data available)

Data Output

Key	Info
by_origin	A list containing routes grouped by origin. origin The ASN (or AS pair including first hop) of the announcing prefix. prefixes A list of prefixes and timelines. prefix The IPv4 or IPv6 prefix in standard notation. timelines Time periods during which this origin announced this prefix. starttime The start time of the period. endtime The end time of the period. full_peers_seeing The number of RIS full-feed peers that saw this route. visibility (if normalise_visibility=true) Visibility of the route according to RIS. In case of unreliable or missing peer information, this value will be "-1".
query_starttime, query_endtime	The start and end time for which the data is valid.
latest_max_ff_peers	This gives the number of maximum full-table peers seen as per IP version in RIS.

Code Examples

cURL

curl --location --request GET "https://stat.ripe.net/data/routing-history/data.json?resource=3333"

JS

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

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

Available versions for this endpoint:

2.3 (current)