---
title: "`POST /geocode/selection`: never charged; capped per key per day."
method: POST
path: "/geocode/selection"
tags: ["geocode"]
---

# \`POST /geocode/selection\`: never charged; capped per key per day.

`POST /geocode/selection`

## Request

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

## Request body

- SelectionRequest
  - `id` string, required: The `id` property of the chosen feature.
  - `query` string, required: The query as typed.

## Response `202`

Selection recorded

- SelectionResponse
  - `status` string, required: Always `"recorded"`.

## Other responses

- `400`: Missing or over-long query/id
- `401`: Missing or invalid API key
- `429`: This key has hit its daily selection cap

---

[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)