ASN Neighbours History

This data call returns information about neigbouring ASNs of a queried ASN extended with history.

https://stat.ripe.net/data/asn-neighbours-history/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/asn-neighbours-history/data.json?resource=AS1205

Parameters

Key Value Info Required
resource ASN for this query This is the ASN the neighbours are shown for. YES
starttime ISO8601 or Unix timestamp Defines the query starttime for the query NO - if not set it falls back to "endtime - 90 days"
endtime ISO8601 or Unix timestamp Defines the query endtime for the query NO - if not set it falls back to the latest available data point
max_rows integer Defines the limit of neighbours to be included in the result, e.g. max_rows=50 means the result will be truncated to 50 neighbours. Has not effect if there are less neighbours anyway. NO - default: 1800

Output

Data

Key Info
neighbours Contains neighbours included in the result with the additional timelines when they were valid

neighbour holds the AS number of the neighbour AS
timelines holds timelines for when this AS was seen as a neighbour
query_starttime/query_endtime Holds the start and endtime for this query
latest_time Holds the time until which data is available
resource Defines the resource used for the query

Example

    "data": {
        latest_time: "2012-09-20T08:00:00",
        "neighbours": [
            {
                "neighbour": 42, 
                "timelines": [
                    {
                        "endtime": "2012-07-23T08:00:24", 
                        "starttime": "2012-07-22T08:00:00"
                    }, 
                    {
                        "endtime": "2012-07-31T16:00:11", 
                        "starttime": "2012-07-23T20:00:02"
                    }, 
                    {
                        "endtime": "2012-08-31T16:00:12", 
                        "starttime": "2012-08-01T08:00:03"
                    }, 
                    {
                        "endtime": "2012-09-20T08:00:00", 
                        "starttime": "2012-09-01T08:00:03"
                    }
                ]
            },
            ...
        ], 
        "query_endtime": "2012-09-20T08:00:00", 
        "query_starttime": "2012-07-22T08:00:00", 
        "resource": "3333"
    }, 

deprecated - 0.4

Difference to 1.*: "resource" field is with the "AS" prefix

upcoming - n.a.

-