POST/v1/probe

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash

curl -fsS -X POST "https://api.mapmap.ai/v1/probe" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json

A gzipped-or-plain JSON probe batch (probe_format: 1): per-segment aggregates, coarse events, and an optional ~5 km geohash origin/destination record. Never a trajectory.

The OpenAPI document declares this body as a free-form JSON object with no field list, so there is nothing here to generate a table from. The prose above is what the gateway states about it; the raw document is the authority.

Responses

202Batch accepted and appended to the probe store

400Malformed batch, wrong probe_format, or a raw-coordinate-looking OD cell

401Missing or invalid API key

403The key is not opted in to probe contribution

501Probe collection is not enabled (SN_PROBE_DIR unset)

Error bodies follow the shared problem model documented on API conventions.

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId post_probe