rir_prefix_history
Fetch the complete registration history for an IP prefix or ASN to view ownership transfers, status changes, and initial registration details.
Instructions
Fetch the complete registration history for an IP prefix or ASN.
Returns a chronological timeline of every change ever recorded:
Initial registration (who, when, under which RIR)
Org / maintainer changes (potential ownership transfers)
Status changes (allocated → assigned → available)
Last-changed updates
Uses RIPE Stat's historical-whois and allocation-history APIs. Coverage is best for RIPE NCC resources; partial for other RIRs.
Use cases:
"Has this IP block ever changed hands?"
"When was this ASN first registered?"
"What organization historically owned this prefix?"
Due diligence, incident response, fraud investigation
Results are cached for 12 hours (historical records are stable).
Args: params (PrefixHistoryInput): - resource (str): IP prefix (e.g. '8.8.8.0/24') or ASN (e.g. 'AS15169') - response_format (str): 'markdown' (default) or 'json'
Returns: str: Chronological event timeline with dates, event types, and attribute changes. JSON schema: { "resource": str, "resource_type": str, "current_holder": str, "current_rir": str, "registration_date": str, "total_events": int, "events": [{"event_date": str, "event_type": str, "attribute": str, "old_value": str, "new_value": str}], "sources": [str], "errors": [str] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |