IP

3 endpoints at a glance

Method	Path	Summary
GET	/addresses/asns/{asn}/	Get ASN info
GET	/addresses/asns/{asn}/dossier	Full AS dossier
GET	/addresses/ips/{ip}/	Get IP address or prefix info

IP

---

Get ASN info

GET

/addresses/asns/{asn}/

ASN enrichment record sourced from RIPE STAT (cached in
db.asns) plus live probe counts aggregated from db.probes.

Pass ?update=true to force a re-fetch from RIPE STAT — probe
counts always recompute regardless.

Also merges a small peeringdb summary onto the response when
the AS is present in the local PeeringDB cache — IXP-count,
facility-count, and a name + type so the lookup view can link to
the full PeeringDB profile without re-fetching.

Parameters

Path Parameters

asn*

Type

integer

Required

Query Parameters

update

Type

boolean

Default

false

Responses

Successful Response

Content-Type

application/json

[

]

GET

/addresses/asns/{asn}/

Playground

Variables

Key

Value

asn*

update

Samples

---

Full AS dossier

GET

/addresses/asns/{asn}/dossier

One-call 'who is this network' composition: ASN overview +
PeeringDB presence (IXPs / facilities) + APNIC user population (latest

• series) + anycast-prefix counts + RIPE Atlas footprint. Warms the
  db.asns cache first (refresh-if-missing) so a cold AS still
  returns a populated dossier.

Parameters

Path Parameters

asn*

Type

integer

Required

Responses

Successful Response

Content-Type

application/json

[

]

GET

/addresses/asns/{asn}/dossier

Playground

Variables

Key

Value

asn*

Samples

---

Get IP address or prefix info

GET

/addresses/ips/{ip}/

IP / CIDR-prefix enrichment record fanned out across RIPE STAT,
IPmap, and IPlocate (cached in db.ips) plus a live list of any
RIPE Atlas probes registered at this address. Accepts both bare
addresses and prefixes (RIPE STAT's resource takes either).

Pass ?refresh=true to force a re-fetch from every upstream —
the probe list always recomputes regardless.

Also merges a small peeringdb summary onto the response when
the IP is either a PeeringDB-known peer address (exact-IP match
against netixlan) or sits inside a PeeringDB-known IXP LAN
prefix. Skipped for CIDR resources (only single addresses can
match a peer or LAN entry meaningfully).

Parameters

Path Parameters

ip*

Type

string

Required

Query Parameters

refresh

Type

boolean

Default

false

Responses

Successful Response

Content-Type

application/json

[

]

GET

/addresses/ips/{ip}/

Playground

Variables

Key

Value

ip*

refresh

Samples

---