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.

-