Prefix Overview
This endpoint gives a summary of the given prefix, including whether and by whom it is announced.
GET /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. |
| query_time | ISO8601 or Unix timestamp | Defines the query time for the lookup | NO - default: latest time data available is available for |
Data Output
| Key | Info |
|---|---|
| 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) and the referencing resource/resources |
| 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 endpoint 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 |
Code Examples
bash
curl --location --request GET "https://stat.ripe.net/data/prefix-overview/data.json?resource=193/23"js
const requestOptions = {
method: 'GET',
};
fetch("https://stat.ripe.net/data/prefix-overview/data.json?resource=193/23", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));