geofeeds

22 endpoints at a glance

Method	Path	Summary
GET	/admin/geofeeds/	Admin Status
POST	/admin/geofeeds/accuracy/run	Accuracy Run
POST	/admin/geofeeds/check-enable	Trigger Check Enable
GET	/admin/geofeeds/check-enable/status	Get Check Enable Status
POST	/admin/geofeeds/discover	Trigger Discovery
GET	/admin/geofeeds/discover/status	Get Discovery Status
GET	/admin/geofeeds/imports/	List Imports
GET	/admin/geofeeds/imports/{import_id}	Get Import
POST	/admin/geofeeds/merge	Merge Source
POST	/admin/geofeeds/refresh	Trigger Refresh
GET	/admin/geofeeds/refresh/status	Get Refresh Status
POST	/admin/geofeeds/resolve-geonames	Trigger Resolve Geonames
GET	/admin/geofeeds/resolve-geonames/status	Get Resolve Geonames Status
DELETE	/admin/geofeeds/sources	Delete Source
PATCH	/admin/geofeeds/sources	Patch Source
GET	/admin/geofeeds/sources/	List Sources
POST	/admin/geofeeds/sources/	Add Source
POST	/admin/geofeeds/unmerge	Unmerge Source
GET	/geofeeds/accuracy/daily	Accuracy Daily
GET	/geofeeds/accuracy/mismatches	Accuracy Mismatches
GET	/geofeeds/accuracy/summary	Accuracy Summary
GET	/geofeeds/lookup/{ip}	Lookup Ip

geofeeds

---

Admin Status

GET

/admin/geofeeds/

Header data for the admin panel — source count, prefix count,
last successful refresh ts, plus worker liveness.

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/admin/geofeeds/

Playground

Headers

authorization

x-api-key

Samples

---

List Sources

GET

/admin/geofeeds/sources/

List geofeed sources with per-source row counts. enabled /
discovery filters mirror the admin-panel toggle chips.
duplicate filters on the merge marker (False powers the
panel's "hide duplicates" default; True shows only merged-away
duplicates).

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

enabled

discovery

duplicate

limit

Type

integer

Default

500

skip

Type

integer

Default

0

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/admin/geofeeds/sources/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

enabled

discovery

duplicate

limit

skip

Samples

---

Add Source

POST

/admin/geofeeds/sources/

Manual add. URL must start with http:// or https://.

Parameters

Header Parameters

authorization

x-api-key

Request Body

application/json

{

  

"url": "string",

  

"label": "string",

  

"enabled": true,

  

"verify_tls": true

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/sources/

Playground

Headers

authorization

x-api-key

Body

Samples

---

Delete Source

DELETE

/admin/geofeeds/sources

Remove the source row + sweep its prefixes. Returns the
deletion tally for the admin toast.

The source URL is passed as a query parameter (not a path segment)
so its scheme's // isn't collapsed to / in transit.

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

url*

The geofeed source URL (its _id).

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

DELETE

/admin/geofeeds/sources

Playground

Headers

authorization

x-api-key

Variables

Key

Value

url*

Samples

---

Patch Source

PATCH

/admin/geofeeds/sources

Update label, enabled flag, or verify_tls without re-importing.

The source URL is passed as a query parameter (not a path segment)
so its scheme's // isn't collapsed to / in transit.

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

url*

The geofeed source URL (its _id).

Type

string

Required

Request Body

application/json

{

  

"label": "string",

  

"enabled": true,

  

"verify_tls": true

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

PATCH

/admin/geofeeds/sources

Playground

Headers

authorization

x-api-key

Variables

Key

Value

url*

Body

Samples

---

Merge Source

POST

/admin/geofeeds/merge

Mark source as a duplicate of into: it's disabled, never
fetched again, and its prefixes are swept (the survivor is
authoritative). The survivor absorbs the duplicate's provenance.
Returns {duplicate, into, removed_prefixes}.

Parameters

Header Parameters

authorization

x-api-key

Request Body

application/json

{

  

"source": "string",

  

"into": "string"

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/merge

Playground

Headers

authorization

x-api-key

Body

Samples

---

Unmerge Source

POST

/admin/geofeeds/unmerge

Undo a merge — clear the duplicate_of marker on url and
drop it from its survivor's aliases. The row stays disabled until the
operator re-enables it.

The URL is a query parameter (not a path segment) so its scheme's
// isn't collapsed to / in transit.

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

url*

The merged-away duplicate URL (its _id).

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/unmerge

Playground

Headers

authorization

x-api-key

Variables

Key

Value

url*

Samples

---

Trigger Refresh

POST

/admin/geofeeds/refresh

Queue a refresh. Returns immediately with the queue depth +
the live progress state. UI polls /refresh/status for live
updates.

Parameters

Header Parameters

authorization

x-api-key

Request Body

application/json

{

  

"url": "string",

  

"all": false

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/refresh

Playground

Headers

authorization

x-api-key

Body

Samples

---

Get Refresh Status

GET

/admin/geofeeds/refresh/status

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/admin/geofeeds/refresh/status

Playground

Headers

authorization

x-api-key

Samples

---

Trigger Discovery

POST

/admin/geofeeds/discover

Queue the whois discovery scan. Walks
db.ips.whois.data.records[] for geofeed: attributes (RFC
8805) + remarks: Geofeed … (RFC 9092); newly-found URLs are
upserted with enabled=False so admin reviews before they're
fetched.

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/discover

Playground

Headers

authorization

x-api-key

Samples

---

Get Discovery Status

GET

/admin/geofeeds/discover/status

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/admin/geofeeds/discover/status

Playground

Headers

authorization

x-api-key

Samples

---

Trigger Resolve Geonames

POST

/admin/geofeeds/resolve-geonames

Queue a GeoNames-resolve pass over db.geofeed_prefixes.
Stamps geonames_id on every prefix row whose country +
city resolves; coords for the cross-check map follow from the
GeoNames link.

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/resolve-geonames

Playground

Headers

authorization

x-api-key

Samples

---

Get Resolve Geonames Status

GET

/admin/geofeeds/resolve-geonames/status

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/admin/geofeeds/resolve-geonames/status

Playground

Headers

authorization

x-api-key

Samples

---

Trigger Check Enable

POST

/admin/geofeeds/check-enable

Queue a TLS check-and-enable pass: each disabled, non-duplicate
source is fetched over TLS (certificate verification on) and, if it
succeeds and returns ≥1 prefix, enabled. Background — poll
/check-enable/status.

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/check-enable

Playground

Headers

authorization

x-api-key

Samples

---

Get Check Enable Status

GET

/admin/geofeeds/check-enable/status

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/admin/geofeeds/check-enable/status

Playground

Headers

authorization

x-api-key

Samples

---

List Imports

GET

/admin/geofeeds/imports/

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

source

since

until

limit

Type

integer

Default

100

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/admin/geofeeds/imports/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

source

since

until

limit

Samples

---

Get Import

GET

/admin/geofeeds/imports/{import_id}

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

import_id*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/admin/geofeeds/imports/{import_id}

Playground

Headers

authorization

x-api-key

Variables

Key

Value

import_id*

Samples

---

Accuracy Run

POST

/admin/geofeeds/accuracy/run

Recompute the accuracy snapshot now. Fire-and-forget — the scan
over the geofeed-stamped db.ips subset can run past the gateway
timeout, so it's handed to a background task and recorded in
db.task_history (derive_geofeed_accuracy, trigger=manual).

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/admin/geofeeds/accuracy/run

Playground

Headers

authorization

x-api-key

Samples

---

Lookup Ip

GET

/geofeeds/lookup/{ip}

Longest-prefix-match against db.geofeed_prefixes. Returns
the same envelope :class:api.atlas.geofeeds.Geofeeds.summarize_ipproduces, ornull`` when no prefix covers the IP.

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

ip*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/geofeeds/lookup/{ip}

Playground

Headers

authorization

x-api-key

Variables

Key

Value

ip*

Samples

---

Accuracy Summary

GET

/geofeeds/accuracy/summary

Current accuracy rollup: per-source agreement %, mismatch counts,
and the worst geofeed sources. null before the first snapshot.

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/geofeeds/accuracy/summary

Playground

Headers

authorization

x-api-key

Samples

---

Accuracy Mismatches

GET

/geofeeds/accuracy/mismatches

Country-mismatching IPs from the current snapshot — declared vs
each inferred source — for investigation.

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

country

Filter on the operator-declared country.

geofeed_source

Filter on the geofeed source URL.

limit

Type

integer

Maximum

1000

Minimum

1

Default

100

skip

Type

integer

Minimum

0

Default

0

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/geofeeds/accuracy/mismatches

Playground

Headers

authorization

x-api-key

Variables

Key

Value

country

geofeed_source

limit

skip

Samples

---

Accuracy Daily

GET

/geofeeds/accuracy/daily

Per-date agreement trend (oldest-first).

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

since

until

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/geofeeds/accuracy/daily

Playground

Headers

authorization

x-api-key

Variables

Key

Value

since

until

Samples

---