---
title: "Probe ingest endpoint (see module docs). Consent-gated, aggregate-only, metered as a free contribution."
method: POST
path: "/v1/probe"
tags: ["collection"]
---

# Probe ingest endpoint (see module docs). Consent-gated, aggregate-only, metered as a free contribution.

`POST /v1/probe`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/v1/probe`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Request body

- object

## Response `202`

Batch accepted and appended to the probe store

- object

## Other responses

- `400`: Malformed batch, wrong probe_format, or a raw-coordinate-looking OD cell
- `401`: Missing or invalid API key
- `403`: The key is not opted in to probe contribution
- `501`: Probe collection is not enabled (SN_PROBE_DIR unset)

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)