Overview

The RIPEstat Data API is the public data interface for RIPEstat. It is the only data source for the RIPEstat widgets.

URL

The basic URL for requesting data is:

https://stat.ripe.net/data/<name>/data.json?param1=value1&param2=value2&...

and to get metadata for a data call, including its methodology:

https://stat.ripe.net/data/<name>/meta

Where:

  • "name" is one of the data calls listed below.

Note: Data call URLs previously began with /plugin/. This will keep working for the forseable future, but /data/ should now be preferred.

Using data calls

Common Request Parameters

To support JSON-P all RIPEstat Data API calls support a "callback" parameter. This parameter can be set to the name of the Javascript function that will be called, with the output data as its argument.

name part of cache key? acceptable values default value? description
callback no - - JSON-P callback
preferred_version yes version of the data call e.g. 0.1 current stable version If the desired version is not available we try to return a version that is matching the major version (e.g. "0" for "0.3"). Use the meta information of a data call to retrieve all available versions, see "Getting metadata for a data call".

Magic version tags supported:
  • "supported" - returns the currently supported version
  • "upcoming" - returns the version that is either a development version and/or a candidate for the next supported version
  • "deprecated" - this will explicitly return a deprecated version
cache - "ignore" - Bypasses and refreshes the cache when set to "ignore". Note that this should only be used when the results of a data call are stale.

Regular Usage

If you are using the API on a regular basic you can use the "sourceapp" parameter to provide a unique identifier to every data call. This identifier helps us to assist you when you encounter any problems with the system. The identifier can be your project name or your company's.

Please drop us a short mail with the identifier and an email address to reach you.
(If you include your project's purpose gold membership support is awaiting you :-)

https://stat.ripe.net/data/<datacallname>/data.json?resource=AS3333&sourceapp=<YourId>

For the format please just use alphanumeric values with no whitespace or special characters.

Output Data Structure

The resulting data has a key=>value structure. Each data call has its own output fields, which are detailed in the individual sections. The common fields that are provided by every call are:

key type value
status string Indicates the status of the result of the data call. Possible values are "ok" for a successful query, "error" for unsuccessful query and "maintenance" in case the data call is undergoing maintenance. In case of an error see the messages field for details.
status_code integer Same as the HTTP status code. In case of server errors the HTTP status code will be set appropriately.
data_call_status string Indicates the status of the data call.
Possible values:
  • supported
    This data call is meant to be stable and without bugs. Any bugs reported will be fixed asap.
  • deprecated(optional with a date)
    This data call is meant to be deprecated and is about to be removed either by the optional date or soon. Reported bugs might be fixed.
  • development
    This data call is currently work in progress and to be considered to change or discontinued without notice. Bug reports are welcome though.
version string major.minor version of the response layout for this particular data call. New minor versions are backwards compatible, new major versions are not.
cached boolean True/False
message string human readable message if there was an error during processing.
process_time string Time it took to process the request, in millisecons. If for some reason the time could not be determined then its value is "not available".
data

The data itself.

Data Overload Prevention

The data overload prevention is to protect users, especially widgets, from getting more data than they can handle. For this reason some data calls already support a soft-limit check which returns a warning if the output looks to be more than usual.

This prevention mechanism should only kick in if the request stems from a browser (the referrer header set), but in case it happens for a non-browser request, it can easily suppressed by the "soft_limit" parameter set to "ignore".

https://stat.ripe.net/data/<datacallname>/data.json?resource=AS3333&soft_limit=ignore

Getting metadata for a data call

A meta request returns additional information about a data call. A simple request to

https://stat.ripe.net/data/<name>/meta

will return the list of currently supported meta calls, like:

  • methodology
    returns the methodology
  • versions
    returns all available versions
  • availability
    returns information on the availability of data. We provide this information to help you to identify which historical queries are possible. Hence this data is only available for data calls supporting time selection parameters.

    The output structure is a list of timelines defined by "starttime" and "endtime" properties.
    If the data call supports different resource types the output structure will change to a list of "available_timeslines" with an "id" property describing the related resource type.

                    
                    {
                        "availability": [
                            {
                                "available_timelines": [
                                    {
                                        "endtime": "2013-12-01T00:00:00", 
                                        "starttime": "2008-11-01T00:00:00"
                                    }
                                ], 
                                "id": "v4"
                            }, 
                            {
                                "available_timelines": [
                                    {
                                        "endtime": "2014-01-07T00:00:00", 
                                        "starttime": "2003-10-09T00:00:00"
                                    }
                                ], 
                                "id": "v6"
                            }
                        ]
                    } 
                
    The "description" property is optional and provides information if this timeline describes a data island.

                    
                    {
                        "availability": {
                            "available_timelines": [
                                {
                                    "endtime": "2014-01-08T09:30:00", 
                                    "starttime": "2012-01-01T00:00:00"
                                }, 
                                ... 
                                {
                                    "description": "Mediterranean Cable Cut", 
                                    "endtime": "2008-02-10T23:59:59", 
                                    "starttime": "2008-01-23T00:00:00"
                                }
                            ]
                        }
                    }
                

    The availability information can also be retrieved as part of a data call - filtered by the given resource type - by providing the parameter "meta=availability":

                    
                    https://stat.ripe.net/data/geoloc/data.json?resource=140.78/16&meta=availability
                

As with a Data API call it's possible to wrap the result into an JSON-P request by appending the "callback" URL parameter, e.g. for methodology

https://stat.ripe.net/data/<name>/meta/methodology?callback=callOnSuccess

Note on SSL

Although it's still possible to use the RIPEstat Data API on a non-secure connection (ordinary HTTP) we strongly encourage using https. If there's a reason for you why you can't use HTTPS at all, please inform us since we will disable HTTP in the near future.

Data Calls




Abuse Contact Finder

The main purpose of this data call is to return abuse contact informations for a Internet number resource. Note that this information is in many cases incorrect or not available.
Additional information:

  • the resources RIR name (if available)
  • whether the queries resource is related to a special purpose Internet number resource (if available)
  • blacklist informations (if available)
  • additional information about the matchin autnum or inet(6)num object in the RIPE DB (e.g. holder name)
  • less and more specific IP prefixes/ranges for IP based queries

https://stat.ripe.net/data/abuse-contact-finder/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/abuse-contact-finder/data.json?resource=193/23

Parameters

Key Value Info Required
resource prefix, single IP address or ASN This is the resource the query is based on. YES

Output

Data

Key Info
authorities List all RIRs that are responsible for the queried resource.
blacklist_info Lists the total amount of entries in one blacklist source. Every blacklist is given with the name as "list" and the number of entries in the field "entries".
global_network_info This contains information that are related to special purpose Internet number resources, e.g. private address space.
anti_abuse_contacts These fields contain the anti-abuse contact informations (if available):
abuse_c Dedicated abuse contact that is according to ripe-563, for details refer to this RIPE Labs article
If the abuse-c contact is available other contact fields (e.g. "extracted_mails") will be omitted and left empty.
emails Any found email address is stated with a "description" and a "email" field
objects_with_remarks Any object that was found to contain anti-abuse related information is listed with a "type" field and a link to the RIPE DB web interface.
extracted_emails Those contacts have been extracted/parsed from a RIPE DB object, the exact reference is given by "object-type" and "object-key".
holder info This contains information found in the matching autnum or inet(6)num object in the RIPE DB.
name "netname" for IP based queries, "as-name" for ASN based queries
resource The resource that is mapped to the object (that doesn't have to be the same as the given input)
less_specific / more_specific Lists more or less specific IP prefixes/ranges found for the given input resource
resource holds the resource the query was based on
query_time holds the time the query was based on

Example

"data": {
        "anti_abuse_contacts": {
            "emails": [
                {
                    "description": "abuse-mailbox", 
                    "email": "abuse@ripe.net", 
                    "via_techc": "yes"
                }
            ], 
            "extracted_emails": [], 
            "objects_with_remarks": []
        }, 
        "authorities": [
            "ripe"
        ], 
        "blacklist_info": [], 
        "global_network_info": {
            "description": "", 
            "name": "RIPE NCC PI Allocation"
        }, 
        "holder_info": {
            "name": "RIPE-NCC", 
            "resource": "193.0.18.0 - 193.0.21.255"
        }, 
        "less_specifics": [
            "193.0.18.0-193.0.21.255", 
            "193.0.0.0-193.0.23.255", 
            "193.0.0.0/16"
        ], 
        "more_specifics": [], 
        "query_time": "2013-03-06T11:25:00", 
        "resource": "193.0.20.50"
    }, 

deprecated - 0.3

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

upcoming - n.a.

-


Address Space Hierarchy

This data call returns address space objects (inetnum, inet6num...) from the RIPE DB (whois) related (exact, more- and less-specific) to the queried resource.

https://stat.ripe.net/data/address-space-hierarchy/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/address-space-hierarchy/data.json?resource=193/21

Parameters

Key Value Info Required
resource prefix or IP range The prefix or IP range the address space hierarchy should be returned for. YES
aggr_levels_below integer between 1 and 64 How many CIDR levels below the queried resource to display more specific resources before aggregating blocks together. NO
max_more_specific integer The maximum number of blocks to return, after aggregation has taken place. NO
rir "ripe" or "apnic" Which RIR to return blocks for. Defaults to "ripe". NO

Output

Data

Key Info
exact A list containing exact matches for the queried resource.
more_specific A list containing first level more specific blocks underneath the queried resource. Some of these may be aggregated according to the 'aggr_levels_below' query parameter.
total_more_specific An integer representing the total number of first level more specific blocks, before aggregation.
less_specific A list containing first level less specific (parent) blocks above the queried resource.
last_updated A structure which describes when the exact-match and less-specific inetnum/inet6num objects were last updated in the database. The inet(6)num attribute's key is "ip_space" and the last updated date's key is "date".
org-names A key-pair structure which links database ORG IDs to their organisation names as described in the respective ORG object. Only for IDs appearing in the exact-match and less-specific objects.
rir Name of the RIR where the results are from
resource Holds the resource the query was based on
query_time Holds the time the query was based on

Example

"data": {
	"exact": [
	    {
	        "admin-c": "JDR-RIPE\nBRD-RIPE", 
	        "country": "NL", 
	        "descr": "RIPE Network Coordination Centre\nAmsterdam, Netherlands", 
	        "inetnum": "193.0.0.0/21", 
	        "mnt-by": "RIPE-NCC-MNT", 
	        "mnt-lower": "RIPE-NCC-MNT", 
	        "netname": "RIPE-NCC", 
	        "remarks": "Used for RIPE NCC infrastructure.", 
	        "source": "RIPE", 
	        "status": "ASSIGNED PI", 
	        "tech-c": "OPS4-RIPE"
	    }
	], 
	"last_updated": [
        {
            "date": "2012-03-09T15:03:38", 
            "ip_space": "193.0.0.0-193.0.23.255"
        }, 
        {
            "date": "2013-03-19T15:24:19", 
            "ip_space": "193.0.0.0/21"
        }
    ],  
	"less_specific": [
	    {
	        "admin-c": "BRD-RIPE", 
	        "country": "NL", 
	        "descr": "Reseaux IP Europeens Network Coordination Centre (RIPE NCC)", 
	        "inetnum": "193.0.0.0-193.0.23.255", 
	        "mnt-by": "RIPE-NCC-HM-MNT", 
	        "mnt-lower": "RIPE-NCC-MNT", 
	        "mnt-routes": "RIPE-NCC-MNT", 
	        "netname": "NL-RIPENCC-OPS-990305", 
	        "org": "ORG-RIEN1-RIPE", 
	        "remarks": "Amsterdam, Netherlands", 
	        "source": "RIPE", 
	        "status": "ALLOCATED PI", 
	        "tech-c": "OPS4-RIPE"
	    }
	], 
	"more_specific": [], 
	"org_names": {
	    "ORG-RIEN1-RIPE": "Reseaux IP Europeens Network Coordination Centre (RIPE NCC)"
	}, 
	"query_time": "2012-11-22T00:00:00", 
	"resource": "193.0.0.0/21", 
	"rir": "ripe", 
	"total_more_specific": 0
}

deprecated - 0.7

Output

Data

Key Info
last_updated A key-pair structure which describes when the exact-match and less-specific inetnum/inet6num objects were last updated in the database. The key is the inet(6)num attribute and the value is the last updated date.

upcoming - n.a.

-


Address Space Usage

This data call shows the usage ratio of this prefix or IP range according to the objects currently present in the RIPE Whois database. The data is represented as assignments, allocations and statistic on the distribution of the IPs covered by the queried resource.

https://stat.ripe.net/data/address-space-usage/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/address-space-usage/data.json?resource=193/23

Parameters

Key Value Info Required
resource prefix or IP range States the prefix or IP range the address space usage should be returned for YES

Output

Data

Key Info
assignments A list of assignments related to the queried resource. Each assignment item has the following structure:

address_space the address space this entry is referring to
asn_name the network name
status the status (for details read the methodology for this data call)
allocation the related allocation for this address range
allocations A list of allocations related to the queried resource. Each allocation item has the following structure:

allocation holds the allocation this entry is referring to
asn_name holds the network name
status holds the status (for details read the methodology for this data call)
assignments hold the number of assignments within this allocation
ip_stats An overview of the distribution of statuses of the covered address space. Each status item has the following structure:

status the name of the status
ips number of IP addresses with this status
resource holds the resource the query was based on
query_time holds the time the query was based on

Example

"data": {
        "allocations": [
            {
                "allocation": "193.0.0.0-195.255.255.255", 
                "asn_name": "EU-ZZ-193-194-195", 
                "assignments": 0, 
                "status": "ALLOCATED UNSPECIFIED"
            }, 
            {
                "allocation": "193.0.0.0/16", 
                "asn_name": "EU-ZZ-19930901", 
                "assignments": 0, 
                "status": "ALLOCATED PI"
            }, 
            {
                "allocation": "193.0.0.0-193.0.23.255", 
                "asn_name": "NL-RIPENCC-OPS-990305", 
                "assignments": 1, 
                "status": "ALLOCATED PI"
            }
        ], 
        "assignments": [
            {
                "address_range": "193.0.0.0/21", 
                "asn_name": "RIPE-NCC", 
                "parent_allocation": "193.0.0.0-193.0.23.255", 
                "status": "ASSIGNED PI"
            }
        ], 
        "ip_stats": [
            {
                "ips": 0, 
                "status": "LIR Free"
            }, 
            {
                "ips": 512, 
                "status": "ASSIGNED PI"
            }, 
            {
                "ips": 0, 
                "status": "RIPE Unallocated"
            }
        ], 
        "query_time": "2012-04-27T12:00:00", 
        "resource": "193.0.0.0/23"
}



Allocation History

This data call returns information supplied by IANA and RIRs for allocations and direct assignments of prefixes and AS numbers of time.

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

e.g. https://stat.ripe.net/data/allocation-history/data.json?resource=140.78/16&starttime=2011-12-12T12:00

Parameters

Key Value Info Required
resource prefix, IP range or ASN YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query YES
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - if not set it falls back to "now"

Output

Data

Key Info
results Contains information on allocations and direct assignments grouped by RIR or IANA. Each block has the following structure:

resource defines the exact resource this entry is about
status defines the status according to the RIRstats
timelines defines the timelines when this entry was valid for (including starttime and endtime)
query_starttime Defines the starttime the query covers
query_endtime Defines the endtime the query covers
resource Defines the resource used for the query

Example

"data": {
        "query_endtime": "2012-04-13T08:00:00", 
        "query_starttime": "2011-12-12T12:00:00", 
        "resource": "140.78.0.0/16", 
        "results": {
            "IANA": [
                {
                    "resource": "140.0.0.0/8", 
                    "status": "Administered by ARIN, LEGACY", 
                    "timelines": [
                        {
                            "endtime": "2012-04-13T00:00:00", 
                            "starttime": "2011-12-12T12:00:00"
                        }
                    ]
                }
            ], 
            "RIPENCC": [
                {
                    "resource": "140.78.0.0-140.78.255.255", 
                    "status": "ASSIGNED", 
                    "timelines": [
                        {
                            "endtime": "2012-04-13T00:00:00", 
                            "starttime": "2011-12-12T12:00:00"
                        }
                    ]
                }
            ]
        }
    }

deprecated - 0.1

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

upcoming - n.a.

-


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. YES
endtime ISO8601 or Unix timestamp The end time for the query. NO - if not set it falls back to "now"
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: 3)

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.
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 - 0.3

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

upcoming - n.a.

-


AS Overview

This data call shows general informations about an ASN like its announcement status and the name of its holder according to the WHOIS service.

https://stat.ripe.net/data/as-overview/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/as-overview/data.json?resource=AS3333

Parameters

Key Value Info Required
resource as states the as you want to get the resource info for yes

Output

Data

Key Info
announced "True" if the prefix is announced, "False" otherwise
holder Descriptive name for the AS if AS is given, "null" otherwise
resource Outputs the AS that query is based on
type For this data call always "as"
block This contains information about this ASN or the ASN block it belongs to. Keys: desc (a human readable description), name (a human readable name), resources (the block), tags (various uses)
resource holds the resource this query based on
query_starttime/query_endtime The time period the query covers. In version 1.1 the result is based on a snapshot instead of a time period. For compatibility reasons "query_starttime" and "query_endtime" will be kept in version 1.x but will hold the same value.

Examples

AS announced:

	 "data": {

	 "announced": true,

	 "holder": "RIPE-NCC-AS RIPE Network Coordination Centre",

	 "resource": "AS3333",

	 "type": "as",
            "block": {
            "desc": "This block contains all 16-bit ASNs, which are allocated
            to the RIRs according to
            http://www.iana.org/assignments/as-numbers/as-numbers.xml. See RFC
            1930\n",
            "name": "the 16-bit ASN Block", 
            "resources": "AS1 - AS65535", 
            "tags": ""
            }
         }

AS NOT announced:

	 "data": {

	 "announced": false,

	 "holder": null,

	 "resource": "2930333",

	 "type": "as"

	 }

deprecated - n.a.

-

upcoming - 2.0

Difference to 1.1: "query_starttime" and "query_endtime" is replaced by "query_time"


AS Path Length

This data call returns AS-path metrics (e.g. shortest or longest AS-path to other ASNs we are peering with) for the queried ASN.

https://stat.ripe.net/data/as-path-length/data.<format><?<parameters> 

e.g. https://stat.ripe.net/data/as-path-length/data.json?resource=AS3333

Parameters

KeyValueInfoRequired
resourceASAS number to queryYES
sort_by "number" (default), "count", "location", "geo" Sort by the given field. In the case of "geo", sort by approximating a world map on to a circle. NO

Output

Data

KeyInfo
stats List of RIS peers that have seen routes to the given AS. Each record has the following format:
   count: number of data points collected,
   location: human readable description of the RIS peer,
   number: unique RIS peer id,
   stripped: {   // stats that exclude AS path prepending
       avg: mean number of path entries, excluding the RIS peer itself,
       max: maximum number of path entries, excluding the RIS peer,
       min: minimum number of path entries, excluding the peer,
       sum: total number of path entries across all data points,
   },
   unstripped: {   // stats that include AS path prepending
       ... // same as for 'stripped',
   }
query_starttime/query_endtime Holds the time period the query covers.
In version 1.1 the result is based on a snapshot instead of a time period. For compatibility reasons "query_starttime" and "query_endtime" will be kept in version 1.x but will hold the same value.
resource Defines the resource used for the query

Example

    "data": {
        "query_endtime": "2012-04-04T12:03:00", 
        "query_starttime": "2012-04-20T12:03:00", 
        "resource": "3333",
        "stats": [
            {
                "count": 231, 
                "location": "RIPE-NCC Multihop, Amsterdam", 
                "number": 0, 
                "stripped": {
                    "avg": 4.796536796536796, 
                    "max": 7, 
                    "min": 3, 
                    "sum": 1108
                }, 
                "unstripped": {
                    "avg": 6.004329004329004, 
                    "max": 9, 
                    "min": 4, 
                    "sum": 1387
                }
            }, 
            ...
 ]

deprecated - 1.0

This version has been superceded by version 1.1 which is using a more reliable backend.

upcoming - 2.0

Difference to version 1.1: "query_endtime" & "query_starttime" have been replaced by "query_time"


AS Routing Consistency

This data call shows the difference between routing and registration state of a ASN.

        https://stat.ripe.net/data/as-routing-consistency/data.<format>?<parameters> 
    

e.g. https://stat.ripe.net/data/prefix-routing-consistency/data.json?resource=AS3333

Parameters

Key Value Info Required
resource asn The ASN to query yes

Output

Data

Key Info
in_bgp "True" if the route has been seen by RIS, "False" otherwise
in_whois "True" if the route exists in IRR or whois, "False" otherwise. For prefixes it is meant to be a Internet Routing Registry, for peers it is meant to be the whois registration of the authoritative Internet registry.
prefix (For prefix routes) the prefix in CIDR notation
peer (For peer exports/imports) the AS number of the peer
query_starttime/query_endtime For routing data: holds the start and end time the query covers
For registration data: query_starttime defines the query time In version 1.1 the result is based on a snapshot instead of a time period. For compatibility reasons "query_starttime" and "query_endtime" will be kept in version 1.x but will hold the same value.
resource Defines the resource used for the query
authority Holds the authoritative Internet registry for the input resource (e.g. RIPE, APNIC, ARIN...)

Example

        "data": {
            "authority": "ripe", 
            "exports": [
                {
                    "in_bgp": false, 
                    "in_whois": true, 
                    "peer": 20481
                }, 
                {
                    "in_bgp": false, 
                    "in_whois": true, 
                    "peer": 8196
                }, 
                ...
                {
                    "in_bgp": true, 
                    "in_whois": true, 
                    "peer": 4637
                }
            ], 
            "imports": [
                {
                    "in_bgp": false, 
                    "in_whois": true, 
                    "peer": 20481
                }, 
                {
                    "in_bgp": true, 
                    "in_whois": false, 
                    "peer": 40962
                }, 
    
                ...
            {
                    "in_bgp": true, 
                    "in_whois": false, 
                    "peer": 559
                }
            ], 
            "prefixes": [
                {
                    "in_bgp": true, 
                    "in_whois": true, 
                    "irr_sources": [
                        "RIPE"
                    ], 
                    "prefix": "193.138.29.0/24"
                }, 
                
                ...
                {
                    "in_bgp": true, 
                    "in_whois": false, 
                    "irr_sources": "-", 
                    "prefix": "193.230.234.0/24"
                }
            ], 
            "query_endtime": "2012-11-15T10:34:00", 
            "query_starttime": "2012-11-15T10:34:00", 
            "resource": "AS6830"
        }, 
    

deprecated - 1.0

This version has been superceded by version 1.1 which is using a more reliable backend.

upcoming - 2.0

Difference to version 1.1: "query_endtime" & "query_starttime" have been replaced by "query_time"


ASN Neighbours

This data call shows information on the network neighbours for a given ASN. This includes statistical information as well as the list of observed ASN neighbours.

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

e.g. https://stat.ripe.net/data/asn-neighbours/data.json?resource=AS1205&starttime=2011-12-01T12:00:00

Parameters

Key Value Info Required
resource ASN for this query The data call will return all neighbours found for this ASN YES
starttime ISO8601 or Unix timestamp Defines the query time for the query.
In this version of the data call, the semantics of the query parameters have been changed to the previous 3.0 version in the way that the end time is no longer taken into account. The returned results are for a specific point in time rather than a time period, which makes it more precise.
If not set, the start time will be set to the latest available data point.
NO

Output

Data

Key Info
neighbour_counts Shows total counts for the neighbours, including the total number of "left", "right" and "unique" neighbours found. Neighbours that have been seen as left neighbours, but only as direct peers of one of our route collectors (RIS collectors), are flagged "uncertain" because our own peering with this ASN could artifically include it as neigbour. ASNs that have been seen as a left neighbour and not as a direct peer with RIS are not flagged as "uncertain".
neighbours Contains all neighbours that were seen at the defined timestamp.
asn Defines the neighbouring ASN.
type Shows information about the neighbour's position ("left" or "right"). The type "uncertain" is explained in the "neighbour_counts" section.
power Shows how many times this neighbour with this type ("left"/"right") was seen in an ASN path. For compatibility reasons, this attribute has kept its name but will change with the next major release.
v4_peers/v6_peers Shows the total number of (full-table) peers, grouped by IP version, seeing this neighbour/position combination.
query_startime/query_endtime For reasons explained in the input parameter section, the query_starttime and query_endtime refer to the same point in time that the result is valid for.
resource Defines the resource used for the query.

Example

                data: {
                    neighbour_counts: {
                        left: 1,
                        right: 0,
                        uncertain: 1,
                        unique: 2
                    },
                    neighbours: [
                        {
                            asn: 1853,
                            power: 79,
                            type: "left",
                            v4_peers: 267,
                            v6_peers: 7
                        },
                        {
                            asn: 35369,
                            power: 1,
                            type: "uncertain",
                            v4_peers: 8,
                            v6_peers: 0
                        }
                    ],
                    query_endtime: "2013-11-05T00:00:00",
                    query_starttime: "2013-11-05T00:00:00",
                    resource: "1205"
                }, 
            

deprecated - 3.0

This data call returns information about the ASNs that neigbour the queried ASN.

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

e.g. https://stat.ripe.net/data/asn-neighbours/data.json?resource=AS1205&starttime=2011-12-01T12:00:00&endtime=2011-12-06T12:00:00

Parameters

Key Value Info Required
resource ASN for this query The data call will return all neighbours found for this ASN. YES
start-/endtime ISO8601 or Unix timestamp Defines the start and end time for the query. NO

Output

Data

Key Info
neighbour_counts Shows total counts for the neighbours, including the total number of left, right and unique neighbours found.
neighbours Contains all neighbours that were seen at the defined timestamp.
asn Defines the neighbouring ASN.
type Shows information about the neighbour's position ("left" or "right").
power Shows how many times this neighbour with this type ("left"/"right") was seen in the routing data.
query_startime/query_endtime The start and end time the query results are valid for.
resource Defines the resource used for the query.

Example

                        "data": {
                            "neighbour_counts": {
                                "left": 2, 
                                "right": 0, 
                                "unique": 2
                            }, 
                            "neighbours": [
                                {
                                    "asn": 35369, 
                                    "power": 8, 
                                    "type": "left"
                                }, 
                                {
                                    "asn": 1853, 
                                    "power": 270, 
                                    "type": "left"
                                }
                            ], 
                            "resource": "1205", 
                            "query_starttime": "2012-02-15T11:30:05",
                            "query_endtime": "2012-02-15T11:30:05"
                        },  
                    

upcoming - 4.0

This data call shows information on the network neighbours for a given ASN. This includes statistical information, the list of observed ASN neighbours and, depending on the level of detail, the ASN paths that this data is based on.

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

e.g. https://stat.ripe.net/data/asn-neighbours/data.json?resource=AS1205&query_time=2011-12-01T12:00:00

Parameters

Key Value Info Required
resource ASN for this query The data call will return all neighbours found for this ASN. YES
lod 0 or 1 Defines how many details are returned in the result. See the output section for further explanation. NO
query_time ISO8601 or Unix timestamp Defines the query time for the query.
If not set, the start time will be set to the latest available data point.
NO

Output

Data

Key Info
neighbour_counts Shows total counts for the neighbours, including the total number of "left", "right" and "unique" neighbours found. Neighbours that have been seen as left neighbours, but only as direct peers of one of our route collectors (RIS collectors), are flagged "uncertain" because our own peering with this ASN could artifically include it as neigbour. ASNs that have been seen as a left neighbour and not as a direct peer with RIS are not flagged as "uncertain".
neighbours Contains all neighbours that were seen at the defined point in time.

Details are only returned if the level of detail ("lod") is 1:
path_count States in how many paths this neighbour/position combination has been seen.
paths Contains details about the paths, including the RRC location where it has been seen and by how many (full-table) peers.
peeer_count Summarizes the number of peers seeing this neighbour/position combination.
asn Defines the neighbour ASN.
position Shows information about the neighbour's position ("left" or "right"). The type "uncertain" is explained in the "neighbour_counts" section.
path_count Shows how many times this neighbour with this position ("left"/"right" or "uncertain") was seen in an ASN path.
peer_count Shows the total number of (full-table) peers, grouped by IP version, seeing this neighbour/position combination.
query_time Reflects the time the data is valid for.
resource Defines the resource used for the query.

Example

                data: {
                    latest_time: "2013-11-05T00:00:00",
                    lod: "1",
                    neighbour_counts: {
                        left: 1,
                        right: 0,
                        uncertain: 1,
                        unique: 2
                    },
                    neighbours: [
                    {
                        asn: 1853,
                        details: {},
                        position: "left"
                    },
                    {
                    asn: 35369,
                    details: {
                    path_count: 1,
                        paths: [
                                {
                                    locations: {
                                        v4: [
                                            {
                                                location: "rrc05",
                                                peer_count: 8
                                            }
                                            ],
                                        v6: [ ]
                                    },
                                    path: "35369 1205"
                                }
                                ],
                                peer_count: {
                                    v4: 8,
                                    v6: 0
                                }
                            },
                                position: "uncertain"
                            }
                        ],
                        query_time: "2013-11-05T00:00:00",
                        resource: "1205"
                    }, 
            


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 "now"
endtime ISO8601 or Unix timestamp Defines the query endtime NO - if not set it falls back to "now - 60 days"
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
resource Defines the resource used for the query

Example

    "data": {
        "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.

-


BGPlay

This data call represents the scenario of what occurred to the BGP routes of a resource over a period of time.
It includes data that defines the initial BGP state at the start time of the query, and all the BGP updates observed from then until the end time, as well as a description of all the AS nodes, and RIS BGP peers involved in the result.

https://stat.ripe.net/data/bgplay/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/bgpplay/data.json?resource=140.78/16&starttime=2012-12-21T07:00&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 - 8h)
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
initial_state The state of the BGP routes for this resource at the starttime. Formatted as defined in the "bgp_state" section of bgp-state.
events The BGP updates observed for this resource during the query time interval. Formatted as defined in the "updates" section of bgp-updates.
nodes Descriptive information of all the ASes present in the AS paths of the BGP routes/updates.

as-number The AS number.
owner The name of the organisation estimated to hold this AS number.
targets List of all the unique target prefixes present in the results.
sources Descriptive information of all the RIS collectors neighbouring peers through which the BGP routes/updates were observed.

id Id of the source peer, as referred to in the BGP entries found in the "initial_state" and "events" sections.
rrc The number of the RIS route collector with which this source is peering.
ip Peering IP address of this RIS neighbour.
as_number AS number of this RIS neighbour.
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": {
        "events": [
            {
                "attrs": {
                    "source_id": "13-193.232.244.15", 
                    "target_prefix": "140.78.0.0/16"
                }, 
                "timestamp": "2012-12-21T07:27:56", 
                "type": "W"
            }, 
            {
                "attrs": {
                    "community": [
                        "9002:9002",
                        "9002:64605"
                    ],
                    "path": [
                        39821, 
                        9002, 
                        1853, 
                        1205
                    ], 
                    "source_id": "13-193.232.244.15", 
                    "target_prefix": "140.78.0.0/16"
                }, 
                "timestamp": "2012-12-21T07:28:46", 
                "type": "A"
            }, 

            (...)
            
        ], 
        "initial_state": [
            {
                "community": [
                    "174:1001",
                    "174:21000",
                    "174:22013",
                    "45896:1001"
                ],
                "path": [
                    45896, 
                    174, 
                    3356, 
                    1853, 
                    1205
                ], 
                "source_id": "00-111.91.233.1", 
                "target_prefix": "140.78.0.0/16"
            }, 
            
            (...)
            
        ], 
        "nodes": [
            {
                "as_number": 174, 
                "owner": "COGENT Cogent/PSI"
            }, 
            {
                "as_number": 286, 
                "owner": "KPN KPN Internet Backbone"
            }, 
            
    	    (...)
    	
        ], 
        "query_endtime": "2012-12-21T12:00:00", 
        "query_starttime": "2012-12-21T07:00:00", 
        "resource": "140.78.0.0/16", 
        "sources": [
            {
                "as_number": 45896, 
                "id": "00-111.91.233.1", 
                "ip": "111.91.233.1", 
                "rrc": "00"
            }, 
            
            (...)
            
        ], 
        "targets": [
            {
                "prefix": "140.78.0.0/16"
            }
        ]
    }



BGP State

This data call returns the state of BGP routes for a resource at a certain point in time, as observed by all the RIS collectors.
This is derived by applying a computation of state to the RIB dump (granularity=8h) that occurred exactly before that time, using the BGP updates observed between the RIB time and the query time.

https://stat.ripe.net/data/bgp-state/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/bgp-start/data.json?resource=140.78/16&timestamp=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
timestamp ISO8601 or Unix timestamp Defines the time for when to perform 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
bgp_state List of BGP routes.

target_prefix Prefix to which this BGP route refers to.
path The AS path in this BGP route, formatted as a list of ASes (first element is the direct BGP neighbour, last element is the origin AS).
community The list of communities in this BGP route.
source_id The id of the route collector (rrc) neighbouring peer through which this BGP route was observed. The format is "[rrc number]-[peer IP address]".
nr_routes The number of BGP routes observed at that time.
query_time Defines the time of the query.
resource Defines the resource used in the query.

Example

    "data": {
        "bgp_state": [
            {
                "community": [
                    "174:1001",
                    "174:21000",
                    "174:22013",
                    "45896:1001"
                ],
                "path": [
                    45896, 
                    174, 
                    3356, 
                    1853, 
                    1205
                ], 
                "source_id": "00-111.91.233.1", 
                "target_prefix": "140.78.0.0/16"
            },
            
            (...)
            
            {
                "community": [ ],
                "path": [
                    13237, 
                    1853, 
                    1205
                ], 
                "source_id": "12-80.81.192.74", 
                "target_prefix": "140.78.0.0/16"
            },
    
            (...)
        ], 
        "nr_routes": 106, 
        "query_time": "2012-12-21T12:00:00", 
        "resource": "140.78.0.0/16"
    }



BGP Updates

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 - 8h)
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]".
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"
            },
            
            (...)
        ]
    }	



BGP Update Activity

This data call returns the number of BGP updates seen over time.

https://stat.ripe.net/data/bgp-update-activity/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/bgp-update-activity/data.json?resource=140.78/16&starttime=2011-12-12T12:00

Parameters

Key Value Info Required
resource prefix, IP range or AS defines the resource the query is carried out on YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query NO - will be calculated from 'endtime' and 'num_hours' (see below).
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - if not set it falls back to "now"
max_samples Positive integer, or 0 to disable BGP events are aggregated in to at most this number of sampling periods NO - defaults to 50
min_sampling_period Positive number of seconds The smallest possible time period for each data point. It will be automatically increased to satisfy 'max_points' NO - defaults to 1 minute
num_hours number If 'starttime' is not given then this parameter will be used to calculate it from the 'endtime' (which defaults to now). NO - defaults to 14 * 24 hours
hide_empty_samples boolean If true (default) then samples with 0 updates will not be returned - they are simply implied by the returned query_startendtime/query_endtime. NO - defaults to true (may be changed in a later release)

Output

Data

Key Info
samples Holds the list of BGP update activities
starttime This defines the beginning of each sample
announcements The number of announcements during this sample
withdrawals The number of withdrawals during this sample
Note: this is currently always 'null' when querying an ASN
sampling_period The duration in seconds of each stated sampling period
sampling_period_human A human-readable version of the sampling period.
query_endtime Defines the endtime the query covers
resource Defines the resource used for the query
resource_type The detected type of the queried resource ("asn", 4 or 6)

Example

    "data": {
        "query_endtime": "2012-04-10T15:00:00", 
        "query_starttime": "2012-04-02T12:00:00", 
        "resource": "140.78.0.0/16", 
        "resource_type": 4,
        "samples": [
            {
                "announcements": 2, 
                "starttime": "2012-04-02T13:06:00", 
                "withdrawals": 0
            }, 
            {
                "announcements": 1, 
                "starttime": "2012-04-02T13:07:00", 
                "withdrawals": 0
            }, 
			... 
            {
                "announcements": 1, 
                "starttime": "2012-04-10T04:57:00", 
                "withdrawals": 0
            }, 
            {
                "announcements": 1, 
                "starttime": "2012-04-10T06:20:00", 
                "withdrawals": 0
            }, 
            {
                "announcements": 1, 
                "starttime": "2012-04-10T06:46:00", 
                "withdrawals": 0
            }, 
            {
                "announcements": 1, 
                "starttime": "2012-04-10T07:01:00", 
                "withdrawals": 0
            }
        ]
    }, 



Blacklist

This data call returns blacklist related data for a queried resource.

https://stat.ripe.net/data/blacklist/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/blacklist/data.json?resource=193/23

Parameters

Key Value Info Required
resource prefix or IP range States the prefix or IP range you want to get blacklist information for YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query YES
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - if not set it falls back to now

Output

Data

Key Info
source Each different data source gets one entry, containing blacklist information for this source.
prefix Holds the prefix of the entry in the blacklist data source.
details If available this holds additional informations about the entry.
timelines Holds time information for the periods the entry appeared in the blacklist data source.
query_starttime Defines the starttime the query covers
query_endtime Defines the endtime the query covers
resource Defines the resource used for the query

Example

"data": {
        "query_endtime": "2012-03-28T10:00:00", 
        "query_starttime": "2012-01-01T12:00:00", 
        "resource": "127.0.0.0-127.255.255.255", 
        "sources": {
            "uceprotect-level1": [
                {
                    "details": "Test Record. UCEPROTECT.NET LEVEL 1 List is active.", 
                    "prefix": "127.0.0.2/32", 
                    "timelines": [
                        {
                            "endtime": "2012-03-01T08:10:00", 
                            "starttime": "2012-01-01T12:00:00"
                        }, 
                        {
                            "endtime": "2012-03-26T08:10:00", 
                            "starttime": "2012-03-04T08:10:00"
                        }
                    ]
                }
            ], 
            "uceprotect-level2": [
                {
                    "details": "Test Record. UCEPROTECT.NET LEVEL 2 List is active", 
                    "prefix": "127.0.0.2/32", 
                    "timelines": [
                        {
                            "endtime": "2012-03-26T08:10:00", 
                            "starttime": "2012-01-01T12:00:00"
                        }
                    ]
                }
            ], 
            "uceprotect-level3": [
                {
                    "details": "Test Record. UCEPROTECT.NET LEVEL 3 List is active", 
                    "prefix": "127.0.0.2/32", 
                    "timelines": [
                        {
                            "endtime": "2012-03-26T08:10:00", 
                            "starttime": "2012-01-01T12:00:00"
                        }
                    ]
                }
            ]
        }
    }, 



Country Resource Stats

This data call returns statistics on Internet resources for a country - this includes:

  • number of ASNs seen in routing data and registration data
  • number of prefixes in routing data and registration data (split into IPv4 and IPv6)
  • amount of IPv4 space seen in routing data as well as registration data
The results can be restricted to a specific time period as well the granularity is variable but can be set explicitly.

Please find details in the methodology of the data call.

https://stat.ripe.net/data/country-resource-stats/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/country-resource-stats/data.json?resource=at&starttime=2012-12-01T12:00&resolution=5m

Parameters

Key Value Info Required
resource 2-digit ISO-3166 country code (e.g. "at","de"...) Defines the country that the stats are returned for YES
starttime ISO8601 or Unix timestamp The start time for the query. See "Default Values for Time Parameters" for details. NO
endtime ISO8601 or Unix timestamp The end time for the query. See "Default Values for Time Parameters" for details. NO
resolution string representation for the resolution Possible values:
  • "5m" - 5 minutes
  • "1h" - 1 hour
  • "1d" - 1 day
  • "1w" - 1 week
NO

Default Values for Time Parameters

Starttime Endtime Defaults
set not set endtime falls back to the lastest time data is available for
not set not set endtime falls back to "now", starttime defaults to beginning of 2004

Output

Data

Key Info
stats Encaplulates the statistics valid for the times seen in the "timeline" field.

asns_ris number of ASNs seen in routing data
asns_stats number of ASNs seen in registration data
v4_prefixes_ris number of v4 prefixes seen in routing data
v4_prefixes_stats number of v4 prefixes seen in registration data
v6_prefixes_ris number of v6 prefixes seen in routing data
v6_prefixes_stats number of v6 prefixes seen in registration data
v4_space_ris amount of v4 address space seen in routing data
v4_space_stats amount of v4 address space seen in registration data
stats_data timestamp of the RIR stat file that is used for the registration data
timeline
starttime Start time of this validity period.
endtime End time of this validity period.
query_starttime The start of the time the query covers.
query_endtime The end of the time the query covers.
resource The resource used for the query.

Example

"data": {
        "query_endtime": "2013-01-21T00:00:00", 
        "query_starttime": "2012-12-01T12:00:00", 
        "resolution": "1w", 
        "resource": "at", 
        "stats": [
            {
                "asns_ris": 365, 
                "asns_stats": 439, 
                "stats_date": "2012-12-01T00:00:00", 
                "timeline": [
                    {
                        "endtime": "2012-12-03T00:00:00", 
                        "starttime": "2012-12-03T00:00:00"
                    }
                ], 
                "v4_prefixes_ris": 1373, 
                "v4_prefixes_stats": 1284, 
                "v4_space_ris": 0, 
                "v4_space_stats": 0, 
                "v6_prefixes_ris": 172, 
                "v6_prefixes_stats": 198
            }, 
            {
                "asns_ris": 367, 
                "asns_stats": 440, 
                "stats_date": "2012-12-07T00:00:00", 
                "timeline": [
                    {
                        "endtime": "2012-12-10T00:00:00", 
                        "starttime": "2012-12-10T00:00:00"
                    }
                ], 
                "v4_prefixes_ris": 1375, 
                "v4_prefixes_stats": 1285, 
                "v4_space_ris": 0, 
                "v4_space_stats": 0, 
                "v6_prefixes_ris": 171, 
                "v6_prefixes_stats": 200
            }, 
            ... 
            {
                "asns_ris": 367, 
                "asns_stats": 444, 
                "stats_date": "2013-01-18T00:00:00", 
                "timeline": [
                    {
                        "endtime": "2013-01-21T00:00:00", 
                        "starttime": "2013-01-21T00:00:00"
                    }
                ], 
                "v4_prefixes_ris": 1401, 
                "v4_prefixes_stats": 1290, 
                "v4_space_ris": 0, 
                "v4_space_stats": 0, 
                "v6_prefixes_ris": 177, 
                "v6_prefixes_stats": 205
            }
        ]
    }, 



Country Resource List

This data call lists the Internet resources associated with a country, including ASNs, IPv4 ranges and IPv4/6 CIDR prefixes.

This data is derived from the RIR Statistics files maintained by the various RIRs.

https://stat.ripe.net/data/country-resource-list/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/country-resource-list/data.json?resource=at&time=2012-12-01T12:00

Parameters

Key Value Info Required
resource 2-digit ISO-3166 country code (e.g. "at","de"...) The country to find IP prefixes and AS numbers for. YES
time ISO8601 or Unix timestamp The time to query. By default, returns the latest available data. NO

Output

Data

Key Info
resources Lists of resources that are associated with the queried country according to the RIR stats files.

asn A sorted list of ASN numbers associated with the queried country.
ipv4 A sorted list of IPv4 prefixes and/or ranges associated with the queried country.
ipv6 A sorted list of IPv6 prefixes associated with the queried country.
query_time The time covered by the query.
resource The resource used for the query.



DNS Chain

This data call returns the recursive chain of DNS forward (A/AAAA/CNAME) and reverse (PTR) records starting form either a hostname or an IP address.

https://stat.ripe.net/data/dns-chain/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/bgp-start/data.json?resource=www.ripe.net

Parameters

Key Value Info Required
resource Hostname or IP address (Ipv4 or IPv6) Defines the resource that the query is performed for. YES

Output

Data

Key Info
forward_nodes A key-value list in which the key is a hostname and the value is the list of IP addresses/hostnames to which it has A/AAAA/CNAME records pointing to.
reverse_nodes A key-value list in which the key is an IP address and the value is the list of hostnames to which it has PTR records pointing to.
nameservers The list of IP addresses of the DNS resolvers used to do perform the DNS queries.
authoritative_nameservers The list of the authoritative nameservers for the returned DNS records.
query_time Defines the time of the query.
resource Defines the resource used in the query.

Example

    "data": {
        "authoritative_nameservers": [
            "pri.authdns.ripe.net.", 
            "ns3.nic.fr.", 
            "sns-pb.isc.org.", 
            "sec3.apnic.net.", 
            "sec1.apnic.net.", 
            "tinnie.arin.net."
        ], 
        "forward_nodes": {
            "www.ipv6.ripe.net": [
                "2001:67c:2e8:22::c100:68b"
            ], 
            "www.ripe.net": [
                "193.0.6.139", 
                "2001:67c:2e8:22::c100:68b"
            ]
        }, 
        "nameservers": [
            "193.0.19.101", 
            "193.0.19.102", 
            "193.0.19.6"
        ], 
        "query_time": "2013-02-19T12:09:00", 
        "resource": "www.ripe.net", 
        "reverse_nodes": {
            "193.0.6.139": [
                "www.ripe.net"
            ], 
            "2001:67c:2e8:22::c100:68b": [
                "www.ipv6.ripe.net"
            ]
        }
    }



Example Resources

This data call returns sample resources for ASN, IPv4 and IPv6 resources. All are taken from routing data.

https://stat.ripe.net/data/example-resources/data.<format> 

e.g. https://stat.ripe.net/data/example-resources/data.json

Parameters

Key Value Info Required
- - - -

Output

Data

Key Info
"asn" Example AS number
"ipv4" Example IPv4 address
"ipv6" Example IPv6 address
"range4" Example IPv4 address range

Example

	data: {
        asn: "1",
        ipv4: "127.0.0.0/16",
        ipv6: "::1/64",
        range4: "127.0.0.0-127.0.255.255"
    }



Geolocation

This data call returns geolocation information for the given IP space, or for announced IP prefixes in the case of ASNs.

IPv4 information is based on GeoLite data created by MaxMind, which is Copyright 2008 MaxMind, Inc. All Rights Reserved. Please consult MaxMind's license before using this data for non-internal usage. For details on the accuracy of this data, please visit MaxMind's product website.

https://stat.ripe.net/data/geoloc/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/geoloc/data.json?resource=193/23

Parameters

Key Value Info Required
resource prefix, IP range, ASN or hostname States the prefix, IP range, ASN or hostname you want to get the geographic information for YES
timestamp ISO8601 or Unix timestamp Defines the times for the query NO - default is time with the lastest available geoloc data

Output

Data

Key Info
locations Contains the geographical locations for the resource is used (Note that the interpretation for ASNs is different than for prefixes and IP ranges). Each location item has the following structure:

city holds the city name - it's not always available
country holds the ISO-3166 country code
covered_percentage defines how much of the entire address space is used at this location
latitude/longitude hold the coordinates defined for this location
prefixes
  • for prefix or IP range: lists the prefixes that are used at this location
  • for ASNs: lists all announced prefixes that entirely OR partially used at this location
unknown_percentage holds the percentage of address space no geographic information could be found for
resource holds the resource the query was based on
query_time holds the time the query was based on (interesting in case no query_time input argument is given)

Example

"data": {
        "locations": [
            {
                "city": "", 
                "country": "NL", 
                "covered_percentage": 100.0, 
                "latitude": 52.5, 
                "longitude": 5.75, 
                "prefixes": [
                    "193.0.0.0/21", 
                    "193.0.10.0/23", 
                    "193.0.12.0/23", 
                    "193.0.18.0/23", 
                    "193.0.20.0/23", 
                    "193.0.22.0/23"
                ]
            }
        ], 
        "query_time": "2012-03-01T00:00:00", 
        "resource": "3333", 
        "unknown_percentage": 0.0
    }

deprecated - 1.1

Difference to 2.*: "resource" field for AS queries is with the "AS" prefix

upcoming - n.a.

-


Geolocation History

This data call returns information on the changes in geolocation for the given IP space, or for announced IP prefixes in the case of ASNs.

IPv4 information is based on GeoLite data created by MaxMind, which is Copyright 2008 MaxMind, Inc. All Rights Reserved. Please consult MaxMind's license before using this data for non-internal usage. For details on the accuracy of this data, please visit MaxMind's product website.

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

e.g. https://stat.ripe.net/data/geoloc-history/data.json?resource=193/23

Parameters

Key Value Info Required
resource prefix, IP range, ASN or hostname States the prefix, IP range, ASN or hostname you want to get the geographic information for YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query YES
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - if not set it falls back to the previous month

Output

Data

Key Info
months Contains for each month of the covered range the geographical distribution.
month Holds the month for which the data in the "distributions" is valid for.
city Holds the name of the city (empty if the city is not available).
country Holds the name of the country.
percentage Holds the percentage value of the address space that is used in this city/country.
query_starttime Defines the starttime the query covers
query_endtime Defines the endtime the query covers
resource Defines the resource used for the query

Example

"data": {
        "months": [
            {
                "distributions": [
                    {
                        "city": "Linz", 
                        "country": "AT", 
                        "percentage": 100.0
                    }
                ], 
                "month": "2010-02-15T00:00:00"
            }, 
            {
                "distributions": [
                    {
                        "city": "Linz", 
                        "country": "AT", 
                        "percentage": 100.0
                    }
                ], 
                "month": "2010-03-15T00:00:00"
            }, 
            {
                "distributions": [
                    {
                        "city": "Linz", 
                        "country": "AT", 
                        "percentage": 100.0
                    }
                ], 
                "month": "2010-04-15T00:00:00"
            }, 
            ...
            {
                "distributions": [
                    {
                        "city": "Linz", 
                        "country": "AT", 
                        "percentage": 100.0
                    }
                ], 
                "month": "2011-12-15T00:00:00"
            }, 
            {
                "distributions": [
                    {
                        "city": "Linz", 
                        "country": "AT", 
                        "percentage": 100.0
                    }
                ], 
                "month": "2012-01-15T00:00:00"
            }, 
            {
                "distributions": [], 
                "month": "2012-02-15T00:00:00"
            }
        ], 
        "query_endtime": "2012-02-28T00:00:00", 
        "query_starttime": "2010-02-01T00:00:00", 
        "resource": "140.78.0.0/16"
}

deprecated - 0.6

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

upcoming - n.a.

-


Looking Glass

This data call returns the output of a direct BGP looking glass query for this IP from all the locations where a RIPE NCC Route Collector is present.

https://stat.ripe.net/data/looking-glass/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/looking-glass/data.json?resource=140.78.0.0/16

Parameters

Key Value Info Required
resource prefix States the prefix you want to get looking glass information for YES

Output

Data

Key Info
rrcs One entry per RRC returning entries for the resource.
entries Groups the entries of the looking glass query per RRC.
as_path States the AS path for the looking glass request.
details These are details that were returned together with the AS path.
no_data_rrcs Contains the RRCs which are not returning any records for this IP.
location Defines the location of the RRC
rrc Defines the name of the RRC
resource Defines the resource used for the query
query_time Defines the timestamp used for the query

Example

"data": {
        "no_data_rrcs": [
            {
                "location": "Tokyo, Japan", 
                "rrc": "RRC06"
            }
        ], 
        "query_time": "2012-04-04T13:37:31.266249", 
        "resource": "140.78.0.0/16", 
        "rrcs": {
            "RRC00": {
                "entries": [
                    {
                        "as_path": "7018 3356 1853 1205", 
                        "details": [
                            "  12.0.1.63 from 12.0.1.63 (12.0.1.63)", 
                            "    Origin IGP, localpref 100, valid, external, best", 
                            "    Community: 7018:5000", 
                            "    Last update: Tue Apr  3 02:08:18 2012"
                        ]
                    }, 
                    {
                        "as_path": "1836 13030 1853 1205", 
                        "details": [
                            "  146.228.1.8 from 146.228.1.8 (146.228.1.8)", 
                            "    Origin IGP, localpref 100, valid, external", 
                            "    Community: 1836:110 1836:6000 1836:6041", 
                            "    Last update: Wed Apr  4 04:44:49 2012"
                        ]
                    }, 
                    ...
                ], 
                "location": "Amsterdam, Netherlands"
            }, 
            ...
            "RRC16": {
                "entries": [
                    {
                        "as_path": "25152 23148 3356 1853 1205", 
                        "details": [
                            "  198.32.124.146 from 198.32.124.146 (199.7.70.32)", 
                            "    Origin IGP, localpref 100, valid, external, best", 
                            "    Community: 25152:5", 
                            "    Last update: Tue Apr  3 03:06:20 2012"
                        ]
                    }
                ], 
                "location": "Miami, Florida, US"
            }
        }
    }, 



M-lab Activity Count

This data call returns a count of all the hosts within a certain resource for which any network tests occurred.

The data is based on active host measurements collected by the Measurement Lab platform (M-Lab).

The measurements are commonly ran using the M-Lab Network Detection Tool (NDT), available as a stand-alone network speed test application, and also included in a popular BitTorrent client.

The results published, including host details are covered by the M-Lab acceptable use policy.

https://stat.ripe.net/data/mlab-activity-count/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/mlab-activity-count/data.json?resource=193.0.0.0/16&starttime=2013-08-21T07:00&endtime=2013-18-27T12:00

Parameters

Key Value Info Required
resource IPv4 Prefix, IPv4 address or 2-digit ISO-3166 country code (e.g. "at","de"...) Defines the resource that the query is performed for. YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query NO - default: (endtime - 7d)
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - default: latest time there is M-Lab data available

Output

Data

Key Info
nr_ips Total number of hosts for which activity was observed.
perc_coverage (Only applicable for prefixes). The amount of address space coverage of the hosts. Equals to nr_clients/number of IPs in the prefix.
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_ips": 6,
        "perc_coverage": 0.0091552734375,
        "query_endtime": "2013-08-29T23:59:59",
        "query_starttime": "2013-08-21T07:00:00",
        "resource": "193.0.0.0/16" 
    }



M-lab Bandwidth

This data call returns a set of all the measured network bandwidths for a certain resource.

The data is based on active host measurements collected by the Measurement Lab platform (M-Lab).

The bandwidth of a host is determined as the maximum network throughput value for all the tests/measurements performed by that host during the specified time period.
The value of the measurement throughput is computed as the number of octets transmitted between the host and the chosen M-Lab server, divided by their transfer time.

The measurements are commonly ran using the M-Lab Network Detection Tool (NDT), available as a stand-alone network speed test application, and also included in a popular BitTorrent client.

The results published, including host details are covered by the M-Lab acceptable use policy.

https://stat.ripe.net/data/mlab-bandwidth/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/mlab-bandwidth/data.json?resource=cy&starttime=2013-08-21T07:00&endtime=2013-18-27T12:00

Parameters

Key Value Info Required
resource IPv4 Prefix, IPv4 address or 2-digit ISO-3166 country code (e.g. "at","de"...) Defines the resource that the query is performed for. YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query NO - default: (endtime - 7d)
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - default: latest time there is M-Lab data available

Output

Data

Key Info
bandwidths List of observed bandwidths in Mbps units. One value per host.
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": {
        "bandwidths": [
            2.484, 
            5.704, 
            5.157, 
            5.912, 
            2.904, 
            3.907, 
            3.843, 
            3.895, 
            1.642, 
            3.985,
            [...]
        ],
        "query_endtime": "2013-08-29T23:59:59", 
        "query_starttime": "2013-08-21T07:00:00", 
        "resource": "cy"
    }



M-lab Clients

This data call returns a set of all the hosts within a certain resource for which any network tests occurred.

The data is based on active host measurements collected by the Measurement Lab platform (M-Lab).

The measurements are commonly ran using the M-Lab Network Detection Tool (NDT), available as a stand-alone network speed test application, and also included in a popular BitTorrent client.

The results published, including host details are covered by the M-Lab acceptable use policy.

https://stat.ripe.net/data/mlab-clients/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/mlab-clients/data.json?resource=193.0.0.0/16&starttime=2013-08-21T07:00&endtime=2013-18-27T12:00

Parameters

Key Value Info Required
resource IPv4 Prefix, IPv4 address or 2-digit ISO-3166 country code (e.g. "at","de"...) Defines the resource that the query is performed for. YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query NO - default: (endtime - 7d)
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - default: latest time there is M-Lab data available

Output

Data

Key Info
clients A key-value list of hosts with network activity, indexed by the host IP address. Each record has the following format.
num_tests The number of tests ran by the host during the query period.
country The country where the host is located (according to Maxmind data).
city The city where the host is located (according to Maxmind data).
latitude The host latitude according to Maxmind data.
longitude The host longitude according to Maxmind data.
nr_clients Total number of hosts in the result.
perc_coverage (Only applicable for prefixes). The amount of address space coverage of the hosts. Equals to nr_clients/number of IPs in the prefix.
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": {
         "clients": { 
            "193.0.166.77": {
                "city": "", 
                "country": "DE", 
                "latitude": 51.0, 
                "longitude": 9.0, 
                "num_tests": 6
            }, 
            "193.0.167.169": {
                "city": "", 
                "country": "DE", 
                "latitude": 51.0, 
                "longitude": 9.0, 
                "num_tests": 3
            },
            "193.0.200.27": {
                "city": "", 
                "country": "RU", 
                "latitude": 60.0, 
                "longitude": 100.0, 
                "num_tests": 6
            },
            [...]
        },
        "nr_clients": 6, 
        "perc_coverage": 0.0091552734375, 
        "query_endtime": "2013-08-29T23:59:59", 
        "query_starttime": "2013-08-21T07:00:00", 
        "resource": "193.0.0.0/16" 
    }



Network Info

This data call returns the containing prefix and announcing ASN of a given IP address.

https://stat.ripe.net/data/network-info/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/network-info/data.json?resource=140.78.90.50

Parameters

Key Value Info Required
resource IP address Any IP address one wants to get network info for YES

Output

Data

Key Info
asns ASNs the prefix is announced from
prefix prefix the requested IP address is in

Example

{
    "asns": [
        "5511",
        "6453"
    ],
    "prefix": "41.138.32.0/20"
}



Prefix Count

This data call shows the number of prefixes announced by a given ASN over time.

https://stat.ripe.net/data/prefix-count/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/prefix-count/data.json?resource=AS3333&starttime=2008-01-01T00:00:00

Parameters

Key Value Info Required
resource AS for the query - YES
starttime ISO8601 or Unix timestamp default: Jan 1st 2000 NO
endtime ISO8601 or Unix timestamp default: now NO
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: 3)

Output

Data

Key Info
ipv4 Contains a series of incremental changes per timestamp on the IPv4 prefixes announced by the AS
ipv6 Contains a series of incremental changes per timestamp on the IPv6 prefixes announced by the AS
timestamp Time of the data point
prefixes Number of prefixes announced by the AS at that point in time
address-space Amount of address space, in terms of /24 (for IPv4) or /48 (for IPv6) subnets, anounced by the AS at that point in time
resource holds the resource this query based on
query_starttime the beginning of the time period the query covers
query_endtime the end of the time period the query covers

Example

    "data": {
	    "ipv4": [
	        {
	            "address-space": 0,
	            "prefixes": 0,
	            "timestamp": "2000-01-01T00:00:00"
	        },
	        {
	            "address-space": 4,
	            "prefixes": 1,
	            "timestamp": "2000-08-20T00:00:00"
	        },
	        {
	            "address-space": 0,
	            "prefixes": 0,
	            "timestamp": "2000-09-08T00:00:00"
	        },
	        {
	            "address-space": 12,
	            "prefixes": 2,
	            "timestamp": "2000-09-09T00:00:00"
	        },
	    	[...]
	    ],
	    "ipv6": [
	   		{
	            "address-space": 0,
	            "prefixes": 0,
	            "timestamp": "2000-01-01T00:00:00"
	        },
	        {
	            "address-space": 64,
	            "prefixes": 1,
	            "timestamp": "2003-03-26T16:00:00"
	        },
	        {
	            "address-space": 0,
	            "prefixes": 0,
	            "timestamp": "2004-03-20T16:00:00"
	        },
			[...]
		],
		"query_endtime": "2012-05-02T12:37:38", 
        "query_starttime": "2000-01-01T00:00:00", 
        "resource": "3333"
	}

deprecated - 0.2

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

upcoming - 1.0

-


Prefix Overview

This data call gives a summary of the given prefix, including whether and by whom it is announced.

https://stat.ripe.net/data/prefix-overview/data.<format>?<parameters> 
        

e.g. https://stat.ripe.net/data/prefix-overview/data.json?resource=193/23

Parameters

Key Value Info Required
resource prefix States the prefix you want to get the resource info for YES
min_peers_seeing integer Minimum number of (RIS) peers necessary to see a resource to be included in the result NO - if not provided a default is choosen by the server. An info message is added if any resource got filtered.
max_related integer Limits the number of related prefixes - if there are any - included in the result NO - if not provided a default is choosen by the server. An info message is added if truncation happens.

Output

Data

Key Info
block This contains information about this Prefix or the Network Block it belongs to. Keys: desc (a human readable description), name (a human readable name), resources (the block), tags (various uses)
announced "True" if the prefix is announced, "False" otherwise
asns A list of ("asn"/"holder") objects representing the originating ASNs. For multi-origin prefixes it's more than one ASN.
holder Descriptive name for the AS if AS is given, "null" otherwise
resource Outputs the prefix that the query is based on
type For this data call always "prefix"
related_prefixes List of related prefixes
actual_num_related Total number of (returned and truncated) related prefixes.
num_filtered_out Number of prefixes (exact or related) filtered by low-visibility filter. This can be controlled by the parameter "min_peers_seeing".
is_less_specific True if the information in the response is for a larger block than the one requested.
resource holds the resource this query based on
query_time defines the query time the result is based on

Examples

        "data": {
                "actual_num_related": 4072, 
                "announced": false, 
                "asns": [], 
                "block": {
                    "desc": "This block is allocated to APNIC by IANA.", 
                    "name": "APNIC IPv4 Address Space", 
                    "resources": "103.0.0.0/8", 
                    "tags": ""
                }, 
                "is_less_specific": false, 
                "num_filtered_out": 83, 
                "query_time": "2014-03-03T08:00:00", 
                "related_prefixes": [
                    "103.0.0.0/16", 
                    "103.1.0.0/22", 
                    "103.1.4.0/24",
                    ... 
                    "103.1.7.0/24", 
                    "103.1.98.0/24", 
                    "103.1.99.0/24", 
                    "103.1.100.0/24"
                ], 
                "resource": "103.0.0.0/9", 
                "type": "prefix"
            },
        

deprecated - 1.0

This data call gives a summary of the given prefix, including whether and by whom it is announced.

https://stat.ripe.net/data/prefix-overview/data.<format>?<parameters> 
                

e.g. https://stat.ripe.net/data/prefix-overview/data.json?resource=193/23

Parameters

Key Value Info Required
resource prefix States the prefix you want to get the resource info for YES

Output

Data

Key Info
block This contains information about this Prefix or the Network Block it belongs to. Keys: desc (a human readable description), name (a human readable name), resources (the block), tags (various uses)
announced "True" if the prefix is announced, "False" otherwise
asns A list of ("asn"/"holder") objects representing the originating ASNs. For multi-origin prefixes it's more than one ASN.
holder Descriptive name for the AS if AS is given, "null" otherwise
resource Outputs the prefix that the query is based on
type For this data call always "prefix"
related_prefixes List of related prefixes
is_less_specific True if the information in the response is for a larger block than the one requested.
resource holds the resource this query based on
query_time defines the query time the result is based on

Examples

prefix announced:

                "data": {
                        "actual_num_related": 0, 
                        "announced": true, 
                        "asns": [
                            {
                                "asn": "1205", 
                                "holder": "Johannes Kepler University"
                            }
                        ], 
                        "block": {
                            "desc": null, 
                            "name": "Legacy space, administered by ARIN", 
                            "resources": "140.0.0.0/8", 
                            "tags": ""
                        }, 
                        "is_less_specific": false, 
                        "query_time": "2012-12-10T00:00:00", 
                        "related_prefixes": [], 
                        "resource": "140.78.0.0/16", 
                        "type": "prefix"
                    },
                

prefix NOT announced:

                "data": {
                        "actual_num_related": 50, 
                        "announced": false, 
                        "asns": [], 
                        "block": {
                            "desc": null, 
                            "name": "Legacy space, administered by ARIN", 
                            "resources": "140.0.0.0/8", 
                            "tags": ""
                        }, 
                        "is_less_specific": false, 
                        "query_time": "2012-12-10T00:00:00", 
                        "related_prefixes": [
                            "140.45.2.0/24", 
                            "140.45.5.0/24", 
                            "140.45.7.0/24", 
                            "140.45.10.0/24", 
                            ... 
                            "140.242.210.0/24", 
                            "140.242.212.0/24", 
                            "140.242.225.0/24", 
                            "140.242.249.0/24", 
                            "140.251.0.0/16"
                        ], 
                        "resource": "140.0.0.0/8", 
                        "type": "prefix"
                    },
                

upcoming - n.a.

-


Prefix Routing Consistency

This data call compares the given routes (prefix originating from an ASN) between Routing Registries and actual routing behaviour as seen by the RIPE NCC route collectors (RIS).

https://stat.ripe.net/data/prefix-routing-consistency/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/prefix-routing-consistency/data.json?resource=193.0.20.0/24

Parameters

Key Value Info Required
resource prefix The prefix to query yes

Output

Data

Key Info
in_bgp "True" if the route has been seen by RIS, "False" otherwise
in_whois "True" if the route exists in whois, "False" otherwise
origin AS number (integer) of the route
asn_name The name of this AS's holder
prefix Prefix (CIDR string) of the route (more or less specific to the input resource)
irr_sources IRR source this route was found in e.g. "RADB", "RIPE", "LEVEL3"...
query_starttime/query_endtime For registration data: query_starttime defines the query time

For routing data: holds the start and end time the query covers
From version 0.6 on the result is based on a snapshot instead of a time period. For compatibility reasons "query_starttime" and "query_endtime" will be kept in version 0.x but will hold the same value.
resource Defines the resource used for the query

Example

    "data": {
        "query_endtime": "2012-11-14T05:19:00", 
        "query_starttime": "2012-11-14T05:19:00", 
        "resource": "193.0.20.0/23", 
        "routes": [
            {
                "asn_name": "RIPE-NCC-AS - Reseaux IP Europeens Network Coordination Centre (RIPE NCC)", 
                "in_bgp": true, 
                "in_whois": true, 
                "irr_sources": [
                    "RIPE"
                ], 
                "origin": 3333, 
                "prefix": "193.0.20.0/23"
            }
        ]
    }

deprecated - 0.5

Difference to 0.6 and up: the result is based on a time period, which is stated in "query_starttime" and "query_endtime";

upcoming - 1.0

Difference to 0.x: "query_starttime" and "query_endtime" is replaced by "query_time"


Prefix Size Distribution

This data call returns the total amount of prefixes announced by a given ASN per subnet size and IP version.

https://stat.ripe.net/data/prefix-size-distribution/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/prefix-size-distribution/data.json?resource=AS3333&time=2011-12-05T12:00:00

Parameters

Key Value Info Required
resource AS for the query - YES
timestamp ISO8601 or Unix timestamp default: now - 2 days NO
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: 3)

Output

Data

Key Info
ipv4 contains prefix sizes of all IPv4 prefixes of the queried ASN
ipv6 contains prefix sizes of all IPv6 prefixes of the queried ASN
count total number of prefixes with the prefix size denoted by size
size Prefix size
resource holds the AS number the result is based on
query_time holds the time of the snapshot the result is based on

Example

    "data": {
        "ipv4": [
            {
                "count": 1, 
                "size": 21
            }, 
            {
                "count": 5, 
                "size": 23
            }
        ], 
        "ipv6": [
            {
                "count": 1, 
                "size": 42
            }, 
            {
                "count": 1, 
                "size": 48
            }
        ], 
        "resource": "3333", 
        "query_time": "2011-12-05T12:00:00"
    }

deprecated - 1.0

Difference to 2.*: "resource" field for AS queries is with the "AS" prefix

upcoming - n.a.

-


Registry Browser

This data call shows relationships between objects in the RIPE Database.

Note: this data call used to be called 'object-relationships'. That is now an alias.

https://stat.ripe.net/data/registry-browser/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/registry-browser/data.json?resource=193.0.20.0/24

e.g. https://stat.ripe.net/data/registry-browser/data.json?resource=organisation:ORG-NCC1-RIPE

Parameters

Key Value Info Required
resource resource The resource to query. This is a prefix (v4/v6), an AS number, or a string of the format "objtype:objkey" for looking up non-numeric database objects yes
use_live_lookups "true" or "false" Whether to request near realtime information from the database. Defaults to "true". If "false", the information may be several hours old but the response time may be slightly quicker. no

Output

Data

Key Info
objects A list of objects (see below) that exactly match the query.
backward_refs A list of objects (see below) that reference the exact match object in one or more of their fields. This will be empty if the query is ambiguous.
forward_refs A list of objects (see below) that are referenced by the exact match in one or more of its fields. This will be empty if the query is ambiguous.
time The point in time that the returned data refers to.
versions A list showing the first and last recorded versions of the 'exact' object. Each version has a start and an end datetime.
num_versions The total number of versions that are recorded for the 'exact' object. This is the total known to the backend, and may be more than the number of objects in the 'versions' list.

Sample object

        {
            "fields": [

                /* Each field contains a key, a value, and the type of
                 * the objects it references, if appropriate.
                 */
                {
                    "key": "route", 
                    "reference": "inetnum", 
                    "value": "193.0.0.0/21"
                }, 
                {
                    "key": "descr", 
                    "reference": null, 
                    "value": "RIPE-NCC"
                }, 
                ...
            ], 

            /* The primary key is the unique identifier for this object.
             * If you combine it into a "key:value" string, it can be used in
             * the 'resource' parameter of this data call.
             */
            "primary": {
                "key": "route", 
                "value": "193.0.0.0/21|AS3333"
            }, 

            /* Each related object contains a list of fields that relate this
             * to the exact match object.
             * This attribute doesn't exist for exact match objects.
            */
            "relationships": [
                "origin"
            ], 
            /* The title key/value forms the "friendly name" for an object, and
             * is not necesarily unique.
             */
            "title": {
                "key": "route", 
                "value": "193.0.0.0/21"
            }
        }, 
    



RIR Prefix Size Distribution

This data call returns the number of allocations and assignments (below the queried resource) according to registration data provided by Regional Internet Registries.

https://stat.ripe.net/data/rir-prefix-size-distribution/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/rir-prefix-size-distribution/data.json?resource=140.0.0.0/8

Parameters

Key Value Info Required
resource Prefix to query for - YES
query_time ISO8601 or Unix timestamp; note that every query_time passed will be normalized to midnight Defines the query time NO

Output

Data

Key Info
rirs A list of prefix size distributions grouped by RIR. Each item has the following structure:

rir AFRINIC, APNIC, ARIN, LACNIC or RIPE NCC
distribution A list of distributions grouped by prefix size. Each distribution has the following strucutre:

prefix_size The prefix size in bits
count The number of prefixes of this size
resource holds the resource this query based on
query_starttime/query_endtime defines the time period the query covers

Example

"data": {
        "query_time": "2012-07-19T00:00:00", 
        "resource": "140.0.0.0/8", 
        "rirs": [
            {
                "distribution": [
                    {
                        "count": 0, 
                        "prefix_size": 8
                    }, 
                    ...
                    {
                        "count": 0, 
                        "prefix_size": 32
                    }
                ], 
                "rir": "LACNIC"
            }, 
            {
                "distribution": [
                    {
                        "count": 0, 
                        "prefix_size": 8
                    }, 
                    {
                        "count": 0, 
                        "prefix_size": 9
                    }, 
                    {
                    ...
                    {
                        "count": 0, 
                        "prefix_size": 32
                    }
                ], 
                "rir": "APNIC"
            }, 
            {
                "distribution": [
                    {
                        "count": 0, 
                        "prefix_size": 8
                    }, 
                    {
                        "count": 0, 
                        "prefix_size": 9
                    }, 
                    ...
                    {
                        "count": 0, 
                        "prefix_size": 32
                    }
                ], 
                "rir": "AFRINIC"
            }, 
            {
                "distribution": [
                    {
                        "count": 0, 
                        "prefix_size": 8
                    }, 
                    {
                        "count": 0, 
                        "prefix_size": 9
                    }, 
                    ...
                    {
                        "count": 0, 
                        "prefix_size": 32
                    }
                ], 
                "rir": "ARIN"
            }, 
            {
                "distribution": [
                    {
                        "count": 0, 
                        "prefix_size": 8
                    }, 
                    {
                        "count": 0, 
                        "prefix_size": 9
                    }, 
                    ... 
                    {
                        "count": 0, 
                        "prefix_size": 32
                    }
                ], 
                "rir": "RIPE NCC"
            }
        ]
    },



RIS Peerings

This data call returns routes for advertisements of a given IP resource, or that are originated from a given ASN, as seen by the RIPE NCC route collectors.

https://stat.ripe.net/data/ris-peerings/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/ris-peerings/data.json?resource=140.78.0.0/16

Parameters

Key Value Info Required
resource Prefix - YES
query_time ISO8601 or Unix timestamp Defines the time for the query NO - default: latest time there is BGP data available

Output

Data

Key Info
peerings A list of ASNs grouped by the RIPE NCC Routing Information Service probe they were seen by. Each group item has the following structure:

probe A RIPE NCC Routing Information Service probe. For each probe the following details are provided:

city / country The probe's human readable location.
longitude / latitude Coordinates of the probe's location.
name ID of the probe.
ixp Name of the internet exchange hosting the probe.
ipv4_peer_count / ipv6_peer_count Number of IPv4 or IPv6 peers with this probe.
peers A list of peers of the route collector probe. For each peer the following details are provided:

asn Autonomous System Number of the peer.
ip IP address of the peer.
ip_version IP version (4 or 6) of the peering IP.
table_version IP family (4 or 6) of the prefix table being passed by the peer. For ASn queries, if the peer announces both IPv4 and IPv6 tables, two separate entries will be present in this peer list.
prefix_count Number of prefixes of the family specified in table_version, announced in this peering session.
routes List of AS-paths (of the table_version family) routes related to the queried prefix/ASn, as passed by the peer.
resource The resource this query based on.
query_starttime/query_endtime The time period the query covers. In the upcoming version 2 this will change to just "query_time".

Example

"data": {
        "peerings": [
            {
                "peers": [
                    {
                        "asn": 50300, 
                        "ip": "176.12.110.8", 
                        "ip_version": "4", 
                        "prefix_count": 432971, 
                        "routes": [
                            {
                                "as_path": [
                                    50300, 
                                    5580, 
                                    2852, 
                                    1853, 
                                    1205
                                ]
                            }
                        ]
                    }, 
                    ... 
                    {
                        "asn": 29049, 
                        "ip": "2a01:6480::1", 
                        "ip_version": "6", 
                        "prefix_count": 9930, 
                        "routes": []
                    }
                ], 
                "probe": {
                    "city": "Amsterdam", 
                    "country": "Netherlands", 
                    "ipv4_peer_count": 22, 
                    "ipv6_peer_count": 10, 
                    "ixp": "RIPE-NCC Multihop", 
                    "latitude": 55.656500000000001, 
                    "longitude": 5.0095299999999998, 
                    "name": "RRC00"
                }
            }, 
            ...
            {
                "peers": [
                    {
                        "asn": 16735, 
                        "ip": "187.16.216.24", 
                        "ip_version": "4", 
                        "prefix_count": 420776, 
                        "routes": [
                            {
                                "as_path": [
                                    16735, 
                                    1239, 
                                    3356, 
                                    1853, 
                                    1205
                                ]
                            }
                        ]
                    }, 
                    ... 
                    {
                        "asn": 0, 
                        "ip": "187.16.216.75", 
                        "ip_version": "4", 
                        "prefix_count": 1, 
                        "routes": []
                    }
                ], 
                "probe": {
                    "city": "Sao Paulo", 
                    "country": "Brazil", 
                    "ipv4_peer_count": 13, 
                    "ipv6_peer_count": 8, 
                    "ixp": "PTTMetro", 
                    "latitude": -23.600200000000001, 
                    "longitude": -46.694699999999997, 
                    "name": "RRC15"
                }
            }
        ], 
        "query_endtime": "2012-08-09T08:09:00", 
        "query_starttime": "2012-08-07T08:09:00", 
        "resource": "140.78.0.0/16"
    },

deprecated - 0.4

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

upcoming - 2.0

Difference to 1.*: query_starttime and query_endtime will be replace by just query_time in the output


Related Prefixes

This data call returns prefixes that overlap or are adjacent to the specified IP resource.

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

e.g. https://stat.ripe.net/data/related-prefixes/data.json?resource=140.78.0.0/16

Parameters

Key Value Info Required
resource Prefix or IP range to query for - YES

Output

Data

Key Info
prefixes contains the related prefixes in a list
prefix contains a single related prefix
origin_asn contains the origin ASN of this related prefix
asn_origin contains the name of the originating ASN
relationship contains the type of relationship (e.g. More Specific, Adjacency - Left)
query_time holds the time when the query was carried out
resource holds the resource the data is based on

Example

   "data": {
        "prefixes": [
            {
                "asn_name": "FR-LYRES Lyon Recherche et Enseignement Sup\ufffdeur (LyRES)", 
                "origin_asn": "AS1945", 
                "prefix": "140.77.0.0/16", 
                "relationship": "Adjacency - Left"
            }, 
            {
                "asn_name": "CSIRO Commonwealth Scientific and Industrial", 
                "origin_asn": "AS6262", 
                "prefix": "140.79.0.0/17", 
                "relationship": "Adjacency - Right"
            }
        ], 
        "query_time": "2012-05-02T12:06:00",
        "resource": "140.78.0.0/16"
    },



Reverse DNS

This data call returns details of reverse DNS delegations for IP prefixes in the RIPE region.

https://stat.ripe.net/data/reverse-dns/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/reverse-dns/data.json?resource=193.0.0.0/21

Parameters

Key Value Info Required
resource Prefix for the query - YES

Output

Data

Key Info
delegations contains domain objects found in the RIPE Whois database related to this prefix (either exact match, more or less-specific) representing reverse delegated zones. Each line is described as "key" and "value" pair.
query_time Holds the time the query was carried out
resource Defines the resource used for the query

Example

"data": {
    "delegations": [
        [
            {
                "key": "domain",
                "value": "46.213.in-addr.arpa"
            },
            {
                "key": "descr",
                "value": "Reverse delegation for Reverse delegation for UPC.nl"
            },
            {
                "key": "admin-c",
                "value": "CBHM-RIPE"
            },
            {
                "key": "tech-c",
                "value": "CBHM-RIPE"
            },
            {
                "key": "zone-c",
                "value": "CBHM-RIPE"
            },
            {
                "key": "nserver",
                "value": "ns3.chello.at"
            },
            {
                "key": "nserver",
                "value": "ns01.chello.com"
            },
            {
                "key": "nserver",
                "value": "ns02.chello.com"
            },
            {
                "key": "nserver",
                "value": "ns.ripe.net"
            },
            {
                "key": "mnt-by",
                "value": "UPCNL-MNT"
            },
            {
                "key": "source",
                "value": "RIPE"
            }
        ]
    ],
    "query_time": "2012-06-01T15:05:00",
    "resource": "213.46.32.0/20"
}



Reverse DNS IP

This is just a simple lookup for the reverse DNS info against a single IP address.

    https://stat.ripe.net/data/reverse-dns-ip/data.<format>?<parameters> 
  

e.g. https://stat.ripe.net/data/reverse-dns/data.json?resource=193.0.6.139

Parameters

Key Value Info Required
resource IP address for the query - YES

Output

Data

Key Info
result A single domain name.

Example

    "data": {
      "query_time": "2013-02-04T15:06:00",
      "resource": "193.0.6.139",
      "result": "www.ripe.net."
    }
  



Routing History

This data call shows the history of announcements for prefixes, including the origin ASN and the first hop.

The data comes from the RIS route collectors.

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

e.g. https://stat.ripe.net/data/routing-history/data.json?resource=AS3333
e.g. https://stat.ripe.net/data/routing-history/data.json?resource=193.0.0.0/21

Parameters

Key Value Info Required
resource prefix or ASN The resource to query. This is a prefix (v4/v6), IP address or AS number. yes
max_rows integer The maximum number of routes to return. This is a soft limit: all recorded routes for each origin ASN are returned, but when the row limit is reached no more origins will be returned. no (default: 3000)
include_first_hop boolean Include the first hop ASN in the route, instead of just the origin ASN. no (default: false)
normalise_visibility boolean Add a visibility field to each timeline indicating the visibility of the route (according to RIS) at that point in time. The visibility is computed as the peers_seeing divided by the number of RIS full table peers at the time. no (default: false)
min_peers integer Minimum number of full-feed RIS peers seeing the route for the segment to be included in the results. Excludes low-visibility/localized announcements. no (default: 3)
starttime ISO8601 or Unix timestamp Defines the starttime for the query no (default: 2004-01-01)
endtime ISO8601 or Unix timestamp Defines the endtime for the query no (default: latest time there is BGP data available)

Output

Data

Key Info
by_origin A list containing routes grouped by origin.
origin The ASN (or AS pair including first hop) of the announcing prefix.
prefixes A list of prefixes and timelines.
prefix The IPv4 or IPv6 prefix in standard notation.
timelines Time periods during which this origin announced this prefix.
starttime The start time of the period.
endtime The end time of the period.
full_peers_seeing The number of RIS full-feed peers that saw this route.
visibility (if normalise_visibility=true) Visibility of the route according to RIS.
query_endtime The time for which the data is valid.
query_starttime The time for which the data is valid.

Example

"data": {
    {
        "by_origin": [
            {
                "origin": "AS3333", 
                "prefixes": [
                    {
                        "prefix": "193.0.0.0/21",
                        "timelines": [
                            {
                                "endtime": "2004-08-31T16:00:00",
                                "full_peers_seeing": 62.43,
                                "starttime": "2004-01-01T00:00:00"
                            }, 
                            "..."
                        ]
                    }, 
                    "..."
                ]
            }, 
            "..."
        ], 
        "resource": "3333",
        "query_endtime": "2013-11-25T00:00:00",
        "query_starttime": "2004-01-01T00:00:00"
    }
}

deprecated - 1.3

Difference to 2.*: "resource" field for AS queries is with the "AS" prefix

upcoming - n.a.

-


Routing Status

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.

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 for which to perform the query no
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: 3)

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
        }
    }
}

deprecated - 2.2

Difference to 3.0: "resource" field for AS queries is with the "AS" prefix

upcoming - n.a.

-


Searchcomplete

This data call returns example resource that are directly or indirectly related to the given input.

https://stat.ripe.net/data/searchcomplete/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/searchcomplete/data.json?resource=RIPE

Parameters

Key Value Info Required
resource term that should tried to be matched against resources - YES
limit number Defines how many suggestions are returned per category NO - default: 6

Output

Data

Key Info
categories This contains a list of objects each with a "category" and a "suggestions" property, which contains the suggestions and defines the category they are belonging to.
resource Reflects the query term that the suggestions are based on.
limit The maximum number of suggestions per category.

Example

"data": {
        "categories": [
            {
                "category": "ASNs", 
                "suggestions": [
                    {
                        "description": "RIPE-MEETING-AS Reseaux IP Europeens Network Coordination Centre (RIPE NCC)", 
                        "label": "AS2121", 
                        "value": "AS2121"
                    }, 
                    {
                        "description": "RIPE-NCC-AS Reseaux IP Europeens Network Coordination Centre (RIPE NCC)", 
                        "label": "AS3333", 
                        "value": "AS3333"
                    }, 
                    {
                        "description": "RIPE-NCC-RIS-AS Reseaux IP Europeens Network Coordination Centre (RIPE NCC)", 
                        "label": "AS12654", 
                        "value": "AS12654"
                    }
                ]
            }, 
            {
                "category": "Domains", 
                "suggestions": [
                    {
                        "description": "ripe.net ranks #11414 on Alexa.com", 
                        "label": "ripe.net", 
                        "value": "ripe.net"
                    }, 
                    {
                        "description": "riper.am ranks #26348 on Alexa.com", 
                        "label": "riper.am", 
                        "value": "riper.am"
                    }
                ]
            }, 
            ...
            {
                "category": "Special", 
                "suggestions": [
                    {
                        "description": "Go to the RIPE Atlas Measurement Targets widget", 
                        "label": "RIPE Atlas Measurement Targets", 
                        "link": "/widget/atlas-targets", 
                        "value": "Go to RIPE Atlas Measurement Targets"
                    }, 
                    {
                        "description": "Go to the RIPE Atlas Probes widget", 
                        "label": "RIPE Atlas Probes", 
                        "link": "/widget/atlas-probes", 
                        "value": "Go to RIPE Atlas Probes"
                    }
                ]
            }
        ], 
        "limit": 3, 
        "query_term": "RIPE", 
        "query_time": "2014-01-09T12:57:00"
    }, 

deprecated - n.a.

-

upcoming - n.a.

-


Visibility

This data call shows how often a particular IP resource has been seen by RIPE NCC route collectors.

        https://stat.ripe.net/data/visibility/data.<format>?<parameters> 
    

e.g. https://stat.ripe.net/data/visibility/data.json?resource=140.78.0.0/16

Parameters

Key Value Info Required
resource Prefix or IP range to query for - YES
starttime ISO8601 or Unix timestamp Defines the starttime for the query NO - default: latest time there is BGP data available
endtime ISO8601 or Unix timestamp Defines the endtime for the query NO - default: latest time there is BGP data available

Output

Data

Key Info
visibilities A list of RIPE NCC Routing Information Service probes with visibility information. Each probe item has the following structure:

ipv4_full_table_peer_count / ipv6_full_table_peer_count Number of full-table peers for IPv4 / IPv6.
ipv4_full_table_peers_not_seeing / ipv6_full_table_peers_not_seeing Lists of peers that don't see the queried resource. Each peer has the following details:

asn Autonomous System Number of the peer.
ip IP address of the peer.
prefix_count The number of prefixes of this IP family passed in the peer full table.
probe Details about the probe:

city / country Human readable location of the probe.
longitude / latitude Coordinates of the probe's location.
name ID of the probe.
ixp Name of the internet exchange hosting the probe.
ipv4_peer_count / ipv6_peer_count Number of IPv4 or IPv6 peers with this probe.
resource The resource this query is based on.
query_starttime/query_endtime The time period the query covers. In version 3.1 the result is based on a snapshot instead of a time period. For compatibility reasons "query_starttime" and "query_endtime" will be kept in version 3.x but will hold the same value.

Example

    "data": {
            "query_endtime": "2012-06-28T10:21:00", 
            "query_starttime": "2012-06-28T10:21:00", 
            "resource": "140.78.0.0/16", 
            "visibilities": [
                {
                    "ipv4_full_table_peer_count": 19, 
                    "ipv4_full_table_peers_not_seeing": [], 
                    "ipv6_full_table_peer_count": 0, 
                    "ipv6_full_table_peers_not_seeing": [], 
                    "probe": {
                        "city": "Amsterdam", 
                        "country": "Netherlands", 
                        "ipv4_peer_count": 22, 
                        "ipv6_peer_count": 8, 
                        "ixp": "RIPE-NCC Multihop", 
                        "latitude": 55.656500000000001, 
                        "longitude": 5.0095299999999998, 
                        "name": "RRC00"
                    }
                }, 
                {
                    "ipv4_full_table_peer_count": 11, 
                    "ipv4_full_table_peers_not_seeing": [
                        {
                            "asn": 30844, 
                            "ip": "195.66.224.68",
                            "prefix_count": 437602
                        }
                    ], 
                    "ipv6_full_table_peer_count": 0, 
                    "ipv6_full_table_peers_not_seeing": [], 
                    "probe": {
                        "city": "London", 
                        "country": "United Kingdom", 
                        "ipv4_peer_count": 71, 
                        "ipv6_peer_count": 14, 
                        "ixp": "LINX", 
                        "latitude": 51.496899999999997, 
                        "longitude": -0.01915, 
                        "name": "RRC01"
                    }
                }, 
                ... 
                {
                    "ipv4_full_table_peer_count": 9, 
                    "ipv4_full_table_peers_not_seeing": [], 
                    "ipv6_full_table_peer_count": 0, 
                    "ipv6_full_table_peers_not_seeing": [], 
                    "probe": {
                        "city": "Sao Paulo", 
                        "country": "Brazil", 
                        "ipv4_peer_count": 13, 
                        "ipv6_peer_count": 8, 
                        "ixp": "PTTMetro", 
                        "latitude": -23.600200000000001, 
                        "longitude": -46.694699999999997, 
                        "name": "RRC15"
                    }
                }
            ]
        }, 
    

deprecated - 3.0

Difference to 3.1: the result is based on a time period, which is stated in "query_starttime" and "query_endtime";

upcoming - 4.0

Difference to 3.1: "query_starttime" and "query_endtime" is replaced by "query_time"


Whats My Ip

This data call returns the IP address of the requestor.

https://stat.ripe.net/data/whats-my-ip/data.<format> 

e.g. https://stat.ripe.net/data/whats-my-ip/data.json

Parameters

Key Value Info Required
- - -

Output

Data

Key Info
ip contains the requester's IP address

Example

	 "data": {

	 "ip": "127.0.0.1"

	 }



Whois

This data call returns whois information from the relevant Regional Internet Registry and Routing Registry.

https://stat.ripe.net/data/whois/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/whois/data.json?resource=192.0.20/23

Parameters

Key Value Info Required
resource ASN/IPv4/IPv6 - YES

Output

Data

Key Info
authorities holds the authorities that were involved in the query (e.g. "ripe", "afrinic", "apnic", "lacnic", "arin", "iana")
records A list of whois records returned for this resource (authorities are combined); each record is an array of entries with the following structure:

key type of the entry (e.g. "aut-num", "as-name"...)
value the value of that entry
details_link in case it's available it provides a link with further informations (either on RIPEstat or the responsible whois database)
irr_records A list of records returned for Routing Registries (RIPE, RADB...); each record is an array of entries with the following structure:

key type of the entry (e.g. "route", "descr", "origin", "source"...)
value the value of that entry
details_link in case it's available it provides a link with further informations (either on RIPEstat or the responsible IRR database)
resource holds the resource the query was based on
query_time holds the time the query was based on

Example

    "data": {
        "authorities": [
            "ripe"
        ], 
        "irr_records": [
            [
                {
                    "details_link": "https://stat.ripe.net/193.0.20.0/23", 
                    "key": "route", 
                    "value": "193.0.20.0/23"
                }, 
                {
                    "details_link": null, 
                    "key": "descr", 
                    "value": "RIPE-NCC"
                }, 
                {
                    "details_link": "https://stat.ripe.net/AS3333", 
                    "key": "origin", 
                    "value": "AS3333"
                }, 
                {
                    "details_link": "https://rest.db.ripe.net/ripe/mntner/RIPE-NCC-MNT", 
                    "key": "mnt-by", 
                    "value": "RIPE-NCC-MNT"
                }, 
                {
                    "details_link": null, 
                    "key": "source", 
                    "value": "RIPE"
                }
            ]
        ], 
        "query_time": "2012-11-21T11:05:00", 
        "records": [
            [
                {
                    "details_link": "https://stat.ripe.net/193.0.18.0-193.0.21.255", 
                    "key": "inetnum", 
                    "value": "193.0.18.0-193.0.21.255"
                }, 
                {
                    "details_link": null, 
                    "key": "netname", 
                    "value": "RIPE-NCC"
                }, 
                {
                    "details_link": null, 
                    "key": "descr", 
                    "value": "RIPE Network Coordination Centre"
                }, 
                {
                    "details_link": null, 
                    "key": "descr", 
                    "value": "Amsterdam, Netherlands"
                }, 
                {
                    "details_link": null, 
                    "key": "remarks", 
                    "value": "Used for RIPE NCC infrastructure."
                }, 
                {
                    "details_link": null, 
                    "key": "country", 
                    "value": "NL"
                }, 
                {
                    "details_link": "https://rest.db.ripe.net/ripe/person-role/JDR-RIPE", 
                    "key": "admin-c", 
                    "value": "JDR-RIPE"
                }, 
                {
                    "details_link": "https://rest.db.ripe.net/ripe/person-role/BRD-RIPE", 
                    "key": "admin-c", 
                    "value": "BRD-RIPE"
                }, 
                {
                    "details_link": "https://rest.db.ripe.net/ripe/person-role/OPS4-RIPE", 
                    "key": "tech-c", 
                    "value": "OPS4-RIPE"
                }, 
                {
                    "details_link": null, 
                    "key": "status", 
                    "value": "ASSIGNED PI"
                }, 
                {
                    "details_link": "https://rest.db.ripe.net/ripe/mntner/RIPE-NCC-MNT", 
                    "key": "mnt-by", 
                    "value": "RIPE-NCC-MNT"
                }, 
                {
                    "details_link": "https://rest.db.ripe.net/ripe/mntner/RIPE-NCC-MNT", 
                    "key": "mnt-lower", 
                    "value": "RIPE-NCC-MNT"
                }, 
                {
                    "details_link": null, 
                    "key": "source", 
                    "value": "RIPE"
                }
            ]
        ], 
        "resource": "193.0.20/23"
    }, 

deprecated - 3.5

Difference to 4.*: "resource" field for AS queries is with the "AS" prefix

upcoming - n.a.

-


Whois Object Last Updated

This data call returns information of when a certain object was last updated in the whois database.

https://stat.ripe.net/data/whois-object-last-updated/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/whois-object-last-updated/data.json?object=AS3333&type=aut-num&source=RIPE

Parameters

Key Value Info Required
object Object name The exact object to query for YES
type Object type Examples: aut-num, inetnum, person, etc YES
source Database source RIPE or APNIC YES
timestamp ISO8601 or Unix timestamp Defines the time for which to perform the query NO
compare_with_live true or false When True (default), the version at the last changed time will be compared with the current live object and indicate if it's different. This will indicate whether there has been at least one modification between "query_time" and "now". NO

Output

Data

Key Info
last_updated holds the time the object was last updated (before the query_time) in the specified Whois database
object holds the object name the query was based on
query_time holds the time the query was based on
same_as_live indicates whether the object at "query_time" is identical to the current live object. Only applicable for RIPE DB objects. Possible values: "yes", "no" or null. null indicates there has been no comparison with the live object and it is therefore unknown. This can be because the mechanism is switched off ("compare_with_live" query option), or it's an object outside the RIPE database.

Example

    "data": {
        "last_updated": "2012-04-17T10:12:15",
    	"object": "AS3333",
    	"query_time": "2012-04-21T00:00:00",
    	"same_as_live": "yes"
    }