Address Space Usage
This data call 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
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 |
| all_level_more_specifics | boolean | This 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
| assignments | A list of assignments from the allocations related to the queried resource. Each assignment item has the following structure:
| address_range | the address space this entry is referring to | | asn_name | the network name | | status | the status of the entry (for details see the RIPE Database documentation sections 4.2.3.2 and 4.2.4.2) | | parent_allocation | the IP range of the allocation that covers this assignment |
|
| allocations | A list of allocations related to the queried resource. Each allocation item has the following structure:
| allocation | the address_range this allocation is referring to | | asn_name | the network name | | status | the status of the entry (for details see the RIPE Database documentation sections 4.2.3.2 and 4.2.4.2) | | assignments | 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 |
Code Examples
Available versions for this data call:
0.4