RPKI History

This data call returns a timeseries with the count of VRPs (Validated ROA Payload) for the requested resource. The data source of this endpoint are the files hosted in ftp.ripe.net/rpki (opens new window).

GET /data/rpki-history/data.json?resource=193.0.22.0/23

Parameters

Key	Value	Info	Required
resource	Prefix ASN 2-digit ISO-3166 country code Trust anchor	The resource to query for. The query returns only matches, for each case: Prefix: those VRPs which have an exact matching prefix ASN: those VRPs which have a matching origin. Country code: those VRPs which are registered under a certain country (according to delegated files). Trust anchor: those VRPs which have ROAs under a certain trust anchor.	YES
family	Integer (4 or 6, default=4)	IP address family to filter for	NO
resolution	Char, one of: d day (default) w week m month y year	Time bin to group the result by. All values except d will return a response with min, avg, max, first, last, and samples. This option doesn't apply when using `include=ranges`.	NO
include	One of: count ranges	count: return the count of VRPs for the queried resource. ranges: the VRPs related to the queried resource, in the form of time ranges.	NO (default: count)
delegated	true/false	If present, the response will include registration information for that resource.	NO

Output

For each element in the timeseries array:

Key	Info
One of: cc prefix asn trust_anchor	The resource queried for.
family	The address family queried for.
rpki	vrp_count The total count of VRPs matching the queried resource.

If querying for delegated information (delegated=true) the response will contain:

delegated	prefixes count Amount of delegated prefixes covered by this resource. covered_by_rpki count Amount of delegated prefixes which are covered by a VRP. space count Amount of address space covered by this resource. covered_by_rpki count Amount of address space which is covered by a VRP.
rpki	vrp_count Amount of VRPs being covered by this resource.

If querying for time ranges (include=ranges) the response will contain:

by_prefix

A list containing VRPs grouped by prefix. prefix The prefix included in this VRP. origins A list of origins and timelines. origin The origin in this VRP. timelines Time periods during which this VRP was seen in the list of VRPs. starttime The start time of the period. endtime The end time of the period. origin The origin included in this VRP. max_length The max_length included in this VRP.

If querying for resolutions other than day (resolution={w,m,y}) the response will get aggregated into weekly (w), monthly (m), or yearly (y) bins according to the option selected by the user, and will contain:

min max avg	The min., max., and avg. VRP count in this time bin.
first last	The first and last VRP count for this time bin. A time bin with resolution=m will report first for the VRP count on 2019-02-01 and last for the one on 2019-02-29.
samples	The amount of samples we have taken under this time bin. If the count happens daily and we query with resolution=m, then months holding 30 days should have 30 samples, those holding 31 days should have 31, and so on.
time	A timestamp in the format "YYYY-mm-ddTHH:MM:SS" aligned with the start of the time bin.

Example 1: querying for a country's VRP count

Example 2: querying for a country's VRP count and its information on delegated files

Example 3: querying for a country's VRP count , its information on delegated files, and binning the data points by year.

current - 0.1