Skip to content

Address Space Usage

This endpoint shows the usage of a prefix or IP range according to the objects currently present in the RIPE database. The data returned lists the assignments and allocations covered by the queried resource as well statistics on the total numbers of IPs in the different categories.

GET /data/address-space-usage/data.json?resource=193/23
Try it

Parameters

KeyValueInfoRequired
resourceprefix or IP rangeStates the prefix or IP range the address space usage should be returned forYES
all_level_more_specificsbooleanThis parameter allows to control that all levels (True) or only the first level (False) of more-specific resources are returned. This can be helpful if large blocks of IP space are looked up and the number of returned resources is too big.NO - default is True, which returns all levels of more specific resources below a given resources

Data Output

KeyInfo
assignmentsA list of assignments from the allocations related to the queried resource. Each assignment item has the following structure:

address_rangethe address space this entry is referring to
asn_namethe network name
statusthe status of the entry (for details see the RIPE Database documentation sections 4.2.3.2 and 4.2.4.2)
parent_allocationthe IP range of the allocation that covers this assignment
allocationsA list of allocations related to the queried resource. Each allocation item has the following structure:

allocationthe address_range this allocation is referring to
asn_namethe network name
statusthe status of the entry (for details see the RIPE Database documentation sections 4.2.3.2 and 4.2.4.2)
assignmentsthe number of assignments within this allocation
ip_statsAn overview of the distribution of statuses of the covered address space. Each status item has the following structure:

statusthe name of the status
ipsnumber of IP addresses with this status
resourceholds the resource the query was based on
query_timeholds the time the query was based on

Code Examples

bash
curl --location --request GET "https://stat.ripe.net/data/address-space-usage/data.json?resource=193/23"
js
const requestOptions = {
	method: 'GET',
};

fetch("https://stat.ripe.net/data/address-space-usage/data.json?resource=193/23", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));

Available versions for this endpoint:

0.4