Routing Status
This endpoint returns a summary of the current BGP routing state of a given IP prefix or ASN, as observed by the RIS 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.
GET /data/routing-status/data.json?resource=AS3333
Parameters
| Key | Value | Info | Required |
|---|---|---|---|
| resource | resource | The resource to query. This is a prefix (v4/v6), IP address or AS number | yes |
| timestamp | 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) |
| min_peers_seeing | boolean | Minimum number of peers seeing the route for it to be included in the results. Excludes low-visibility/localized announcements. | no (default: 10) |
Data Output
| Key | Info | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| first_seen/last_seen | Information on when and how the resource was first and last seen in BGP. The following structure is present only if the resource was ever seen in BGP.
| ||||||||||||
| visibility | The BGP visibility of the resource, in terms of RIS peers seeing the resource versus total peers, separated over IPv4 and IPv6.
| ||||||||||||
| announced space (only for resources of type: AS) | Indicates the amount of address space currently announced by that AS number.
| ||||||||||||
| observed_neighbours (only for resources of type: AS) | The amount of unique ASes which are observed to be BGP neighbours of the queried AS at this point in time. Note that the AS might have more neighbours than is specified here, but they are not observed by the RIS collectors. | ||||||||||||
| origins (only for resources of type: prefix) | The list of origin ASes which currently announce this exact match prefix. Each item has the following structure:
| ||||||||||||
| less_specifics/more_specifics (only for resources of type: prefix) | The list of less specific and more specific prefixes related to the queries prefix currently announced in BGP. Each list is limited to a maximum of 50 items. Each item has the following structure:
| ||||||||||||
| resource | The resource this query is based on. | ||||||||||||
| query_time | The time for which the data is valid. |
Code Examples
bash
curl --location --request GET "https://stat.ripe.net/data/routing-status/data.json?resource=3333"js
const requestOptions = {
method: 'GET',
};
fetch("https://stat.ripe.net/data/routing-status/data.json?resource=3333", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));