Announced Prefixes

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

https://stat.ripe.net/data/announced-prefixes/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/announced-prefixes/data.json?resource=AS3333&starttime=2011-12-12T12:00

Parameters

Key Value Info Required
resource ASN The Autonomous System Number for which to return prefixes. YES
starttime ISO8601 or Unix timestamp The start time for the query. NO - defaults to two weeks before current date and time
endtime ISO8601 or Unix timestamp The end time for the query. NO - if not set it falls back to current date and time
min_peers_seeing integer Minimum number of RIS peers seeing the prefix for it to be included in the results. Excludes low-visibility/localized announcements. NO (default: 10)

Output

Data

Key Info
prefixes A list of all announced prefixes + the timelines when they were visible.
prefix The announced prefix.
timelines All the timelines when the prefix was announced.
starttime Start time of this period.
endtime End time of this period.
query_starttime The start of the time the query covers.
query_endtime The end of the time the query covers.
latest_time & earliest_time Holds the latest and the earliest time data is available for.
resource The resource used for the query.

Example

    "data": {
        "prefixes": [
            {
                "prefix": "193.0.0.0/21",
                "timelines": [
                    {
                        "endtime": "2011-12-13T00:00:00",
                        "starttime": "2011-12-12T12:00:00"
                    },
                    {
                        "endtime": "2011-12-13T08:00:00",
                        "starttime": "2011-12-13T08:00:00"
                    },
                    {
                        "endtime": "2011-12-15T16:00:00",
                        "starttime": "2011-12-13T16:00:00"
                    },
                    {
                        "endtime": "2011-12-16T16:00:00",
                        "starttime": "2011-12-16T00:00:00"
                    },
                    {
                        "endtime": "2011-12-20T16:00:00",
                        "starttime": "2011-12-17T00:00:00"
                    },
...
                    {
                        "endtime": "2012-01-17T00:00:00",
                        "starttime": "2012-01-16T08:00:00"
                    }
                ]
            },
            {
                "prefix": "2001:67c:2e8::/48",
                "timelines": [
                    {
                        "endtime": "2011-12-13T00:00:00",
                        "starttime": "2011-12-12T12:00:00"
                    },
...
                    {
                        "endtime": "2012-01-17T00:00:00",
                        "starttime": "2012-01-17T00:00:00"
                    }
                ]
            }
        ],
        "query_endtime": "2012-01-18T13:21:51.305237",
        "query_starttime": "2011-12-12T12:00:00",
        "resource": "3333"
    },

deprecated - 1.0

Difference to 1.1: the latest version is based on a more reliable backend

upcoming - n.a.

-