Skip to content
Documentation menu
docs / api / post-v1-keys-verify-details
Keys and account

POST/v1/keys/verify/details

Access and price

AuthNo key. Not metered.
PriceNot metered: no quota, no credit.

What it does

What the confirmation page shows: the request behind a link, without consuming it. A POST, so the token stays out of URLs and logs.

No key. Not metered.

Call it

bash
curl -fsS -X POST "https://api.mapmap.ai/v1/keys/verify/details" \
  -H "Content-Type: application/json" \
  -d '{"token":"string"}'

Request body

application/json · VerifyTokenBody

FieldTypeRequiredDescription
tokenstringyesThe single-use token from the emailed link (the #t= fragment, or the ?token= query of a link sent before the fragment form).

Example: A request assembled from this schema's own field examples, enums, defaults and types; not a recorded call

json
{
  "token": "string"
}

Responses

200The request behind the link; nothing changes
FieldTypeRequiredDescription
kindstringyes"new-signup" when nobody has verified the address yet (the welcome mail), "new-key-on-account" when the address already has a verified key (the owner notice).
requestKeyRequestViewyesWhat the request said about itself, when and roughly where.
statestringyesThe key's state: provisional until confirmed, verified once it is.

Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call

json
{
  "kind": "string",
  "request": {
    "device": "string",
    "requested_at": "string",
    "requested_at_text": "string",
    "source": "string"
  },
  "state": "string"
}
400Missing, unknown, used or expired token

application/problem+json · Problem

413The request declares a body larger than 1048576 bytes (plain text, not problem+json)

text/plain

504The request did not finish within the gateway's request deadline (request-timeout)

application/problem+json · Problem

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

Also under Keys and account

Generated from https://api.mapmap.ai/openapi.json on 2026-11-18 · operationId verify_details