graphs

3 endpoints at a glance

Method	Path	Summary
GET	/graphs/probes/new/	Get Probes New
GET	/graphs/probes/new/list/	Get Probes New List
GET	/graphs/probes/new/map/	Get Probes New Map

graphs

Graphing API endpoints

---

Get Probes New

GET

/graphs/probes/new/

New-probes graph — Mongo-backed.

Replaces the legacy CouchDB implementation. Same wire surface,
same envelope shape; filters and group dimensions that depend on
data not yet in Mongo are accepted but ignored, with their names
echoed in dropped_filters / dropped_groups so the UI can
surface a notice.

Parameters

Query Parameters

start

stop

date

group

Default

"days"

country

city

region

asn

status

firmware_version

anchors

explain

Type

boolean

Default

false

query_field

limit

Type

integer

Default

10000

version

reporting

hardware

eyeballs

report_2024

Responses

Successful Response

Content-Type

application/json

[

]

GET

/graphs/probes/new/

Playground

Variables

Key

Value

start

stop

date

group

country

city

region

asn

status

firmware_version

anchors

explain

query_field

limit

version

reporting

hardware

eyeballs

report_2024

Samples

---

Get Probes New List

GET

/graphs/probes/new/list/

New-probes flat list — Mongo-backed.

Companion to :func:get_probes_new; shares the same selector
semantics but returns one rows entry per matching probe (no
grouping) with the table columns: id, description, country, ASN,
status, type, city, first_connected. No group parameter — this
isn't a grouping view.

Parameters

Query Parameters

start

stop

date

country

city

region

asn

status

firmware_version

anchors

query_field

limit

Type

integer

Default

10000

version

reporting

hardware

eyeballs

report_2024

Responses

Successful Response

Content-Type

application/json

[

]

GET

/graphs/probes/new/list/

Playground

Variables

Key

Value

start

stop

date

country

city

region

asn

status

firmware_version

anchors

query_field

limit

version

reporting

hardware

eyeballs

report_2024

Samples

---

Get Probes New Map

GET

/graphs/probes/new/map/

New-probes geographic projection — Mongo-backed.

Companion to :func:get_probes_new; shares the same selector
semantics so the bar-chart and the map tab in the frontend stay
coherent. Returns one points entry per matching probe that
has a public location. Probes with data.geometry == null
are excluded; the omitted count is surfaced separately so the
frontend can render a "X have no public location" caption.

No group parameter — this isn't a grouping view; the bar-chart
endpoint owns that.

Parameters

Query Parameters

start

stop

date

country

city

region

asn

status

firmware_version

anchors

query_field

limit

Type

integer

Default

10000

version

reporting

hardware

eyeballs

report_2024

Responses

Successful Response

Content-Type

application/json

[

]

GET

/graphs/probes/new/map/

Playground

Variables

Key

Value

start

stop

date

country

city

region

asn

status

firmware_version

anchors

query_field

limit

version

reporting

hardware

eyeballs

report_2024

Samples

---