Transfer Commands¶

The transfer family fetches APNIC IP/ASN transfer and resource-change records. Three top-level commands cover three different datasets: transfers (the daily JSON transfer snapshot, optionally by year), transfers-all (the cumulative historical pipe-delimited log since 2010), and changes (per-resource change events as JSON Lines).

Source: cmd_transfers_changes.go.

Command and Dataset Map¶

graph TB
    subgraph LATEST["Daily snapshot (JSON)"]
        TL["transfers<br/>transfers_latest.json"]
        TY["transfers --year YYYY<br/>JCR-format log for one year"]
    end

    subgraph CUM["Cumulative archive (pipe-delimited)"]
        TA["transfers-all<br/>all transfers since 2010"]
        TAD["transfers-all --date YYYYMMDD<br/>one daily archive"]
    end

    subgraph CHG["Per-resource events (JSON Lines)"]
        CH["changes<br/>latest change log"]
        CHD["changes --date YYYYMMDD<br/>one day's changes"]
    end

    TL -.->|"default"| LATEST
    CH -.->|"default"| LATEST
    TA -.->|"default"| LATEST

apnic transfers¶

Fetch APNIC inter- and intra-RIR IP/ASN transfer records. By default fetches the latest transfers (transfers_latest.json). Use --year YYYY to fetch the JCR-format transfer log for that year.

Examples¶

# Latest transfer snapshot
apnic transfers

# Transfer log for a specific year
apnic transfers --year 2024

apnic --json transfers --year 2024 | jq '.transfers[0:5]'

Output format (human-readable)¶

# transfers: 128 records (year=latest)

With --year, the summary reads (year=2024). The human-readable output is the summary line only; the structured records are emitted under --json as the TransfersResult struct (transfers[]).

apnic transfers-all¶

Fetch the APNIC cumulative transfers-all log. Unlike transfers (the daily JSON snapshot), this is the historical pipe-delimited format covering every IP/ASN transfer recorded since 2010. Use --date YYYYMMDD for a specific daily archive; omit for the latest cumulative file.

Examples¶

# Latest cumulative transfers-all log
apnic transfers-all

# Cumulative log as of a specific date
apnic transfers-all --date 20220904

apnic --json transfers-all --date 20220904 | jq '.records[0:5]'

Output format (human-readable)¶

# transfers-all: 4156 records (date=latest)
ipv4    203.0.113.0/24  ORG-A-AP    ORG-B-AP    Inter-RIR   20220904
asn 64512   ORG-A-AP    ORG-B-AP    Intra-RIR   20220601
...

Columns are tab-separated: ResourceType Resource FromOrganisation ToOrganisation TransferType TransferDate. The transfer date is rendered as YYYYMMDD.

apnic changes¶

Fetch APNIC resource change records (JSON Lines). Each record describes a delegated, cc-changed, or status-changed event for a resource. By default fetches the latest; use --date YYYYMMDD for a specific snapshot.

Examples¶

# Latest change log
apnic changes

# Changes for a specific date
apnic changes --date 20240601

apnic --json changes --date 20240601 | jq '.changes[0:5]'

Output format (human-readable)¶

# changes: 932 records (date=latest)

The summary line reports (date=latest) or the supplied date. The structured records are emitted under --json as the ChangesResult struct (changes[]).

Date and Year Resolution¶

flowchart LR
    A["apnic transfers / transfers-all / changes"] --> B{"flag set?"}
    B -- "none" --> L["fetch latest file"]
    B -- "--year YYYY" --> Y["transfers: JCR log for that year"]
    B -- "--date YYYYMMDD" --> D["transfers-all / changes: daily archive"]
    L --> O["output: human / --json"]
    Y --> O
    D --> O

The summary line in human-readable output echoes the resolved value: year=latest / year=2024 for transfers, and date=latest / date=20240601 for transfers-all and changes. --year is only valid on transfers; --date is only valid on transfers-all and changes.

Global flags of note¶

Output summary¶