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.
query_time ISO8601 or Unix timestamp Defines the query time for the lookup NO - default: latest time data available is available for

Output

Data

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

-