This data call 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.
https://stat.ripe.net/data/routing-status/data.<format>?<parameters> 
e.g. https://stat.ripe.net/data/routing-status/data.json?resource=AS3333
e.g. https://stat.ripe.net/data/routing-status/data.json?resource=193.0.0.0/21
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)
|
Output
Data
|
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.
| time |
The time when the resource was first/last seen. |
| origin |
The origin AS in the route when the resource was first/last seen. |
| prefix |
The prefix in the route when the resource was first/last seen. |
|
|
visibility
|
The BGP visibility of the resource, in terms of RIS peers seeing the resource versus total peers, separated over IPv4 and IPv6.
|
v4/v6
|
The IP family of table announced by the peers.
| ris_peers_seeing |
The number of full-table (of that IP family) RIS peers currently seeing the resource. |
| total_ris_peers |
The total number of full-table (of that IP family) RIS peers, at that point in time. |
|
|
announced space
(only for resources of type: AS)
|
Indicates the amount of address space currently announced by that AS number.
| v4 |
| prefixes |
The number of IPv4 prefixes announced by the ASn. |
| ips |
The total amount of IPv4 address space announced by the ASn by combining all the prefixes in terms of unique IP addresses. |
|
| v6 |
| prefixes |
The number of IPv6 prefixes announced by the ASn. |
| /48s |
The total amount of IPv6 address space announced by the ASn by combining all the prefixes in terms of unique /48 subnets. |
|
|
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:
|
origin
|
The origin AS.
|
|
route_objects
|
A list of routing registry sources where there is a route object exactly matching this prefix and origin AS.
|
|
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:
|
prefix
|
The less/more specific prefix.
|
|
origin
|
The origin AS which announces the prefix.
|
|
|
resource
|
The resource this query is based on.
|
|
query_time
|
The time for which the data is valid.
|
Example
"data": {
"announced_space": {
"v4": {
"ips": 4608,
"prefixes": 6
},
"v6": {
"48s": 1,
"prefixes": 1
}
},
"first_seen": {
"origin": 3333,
"prefix": "193.0.0.0/22",
"time": "2000-08-20T00:00:00"
},
"last_seen": {
"origin": 3333,
"prefix": "193.0.0.0/21",
"time": "2012-10-25T00:00:00"
},
"observed_neighbours": 161,
"query_time": "2012-10-25T00:00:00",
"resource": "3333",
"visibility": {
"v4": {
"ris_peers_seeing": 90,
"total_ris_peers": 90
},
"v6": {
"ris_peers_seeing": 83,
"total_ris_peers": 83
}
}
}