Skip to content

Announced Prefixes

This endpoint returns all announced prefixes for a given ASN. The results can be restricted to a specific time period.

GET /data/announced-prefixes/data.json?resource=AS3333&starttime=2020-12-12T12:00
Try it

Parameters

KeyValueInfoRequired
resourceASNThe Autonomous System Number for which to return prefixes.YES
starttimeISO8601 or Unix timestampThe start time for the query.NO - defaults to two weeks before current date and time
endtimeISO8601 or Unix timestampThe end time for the query.NO - if not set it falls back to current date and time
min_peers_seeingintegerMinimum number of RIS peers seeing the prefix for it to be included in the results. Excludes low-visibility/localized announcements.NO (default: 10)

Data Output

KeyInfo
prefixesA list of all announced prefixes + the timelines when they were visible.
prefixThe announced prefix.
timelinesAll the timelines when the prefix was announced.
starttimeStart time of this period.
endtimeEnd time of this period.
query_starttimeThe start of the time the query covers.
query_endtimeThe end of the time the query covers.
latest_time & earliest_timeHolds the latest and the earliest time data is available for.
resourceThe resource used for the query.

Code Examples

bash
curl --location --request GET "https://stat.ripe.net/data/announced-prefixes/data.json?resource=3333&starttime=2020-12-12T12:00"
js
const requestOptions = {
	method: 'GET',
};

fetch("https://stat.ripe.net/data/announced-prefixes/data.json?resource=3333&starttime=2020-12-12T12:00", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));

Available versions for this endpoint:

1.2 (current)