This data call returns the BGP updates observed for a resource over a certain period of time.
https://stat.ripe.net/data/bgp-updates/data.<format>?<parameters>
e.g. https://stat.ripe.net/data/bgp-updates/data.json?resource=140.78/16&endtime=2012-12-21T12:00
Parameters
Key
|
Value
|
Info
|
Required
|
resource
|
Prefix, IP address, AS or a list of valid comma-separated resources
|
Defines the resource that the query is performed for. If a list of resources is supplied, the results will be combined for all of them.
|
YES
|
starttime
|
ISO8601 or Unix timestamp
|
Defines the starttime for the query
|
NO - default: (endtime - 48h)
|
endtime
|
ISO8601 or Unix timestamp
|
Defines the endtime for the query
|
NO - default: latest time there is BGP data available
|
rrcs
|
Single-value or comma-separated values of RRC numbers (4 or 0,4,12,15)
|
The list of Route Collectors (RRCs) to get the results from.
|
NO - default behaviour: all RRCs
|
unix_timestamps
|
TRUE or FALSE
|
If TRUE, will format the timestamps in the result as Unix timestamp.
|
NO - default: FALSE
|
Output
Data
Key
|
Info
|
updates
|
List of observed BGP updates, in chronological order of occurrence.
type |
Type of BGP update: "A"=Announcement, "W"=Withdrawal. |
timestamp |
Time (UTC) of the BGP update. |
attrs |
Attributes of the BGP update (some fields depend on the update type).
target_prefix |
Prefix to which this BGP update refers to. |
path (only on A update types) |
The AS path in this BGP announcement, formatted as a list of ASes (first element is the direct BGP neighbour, last element is the origin AS). |
community (only on A update types) |
The list of communities in this BGP announcement. |
source_id |
The id of the route collector (rrc) neighbouring peer through which this BGP update was observed. The format is "[rrc number]-[peer IP address]". |
|
seq |
Sequential integer ordering the received BGP events |
|
nr_updates
|
The number of BGP updates observed in this time period.
|
query_starttime
|
Defines the start of the time interval covered in the query.
|
query_endtime
|
Defines the end of the time interval covered in the query.
|
resource
|
Defines the resource used in the query.
|
Example
"data": {
"nr_updates": 13,
"query_endtime": "2012-12-21T12:00:00",
"query_starttime": "2012-12-21T04:00:00",
"resource": "140.78.0.0/16",
"updates": [
{
"community": [
"14840:20",
"14840:7110"
],
"attrs": {
"path": [
14840,
18881,
3549,
3356,
1853,
1205
],
"source_id": "15-187.16.216.219",
"target_prefix": "140.78.0.0/16"
},
"timestamp": "2012-12-21T04:40:06",
"type": "A"
},
(...)
{
"attrs": {
"source_id": "13-193.232.244.15",
"target_prefix": "140.78.0.0/16"
},
"timestamp": "2012-12-21T07:27:56",
"type": "W"
},
(...)
]
}