Skip to content

50,000 free calls a month, card-free. Get an API key →

Log inGet an API key
Documentation menu
docs / api / post-v1-keys-verify-details
self-serve

POST/v1/keys/verify/details

Public. No key, and no quota deducted.

Call it

bash
curl -fsS -X POST "https://api.mapmap.ai/v1/keys/verify/details" \
  -H "Content-Type: application/json" \
  -d @request.json

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

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.
400Missing, unknown, used or expired token

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

Also under self-serve

GET /v1/jobsGET /v1/jobs/{id}POST /v1/keysDELETE /v1/keys/selfGET /v1/keys/selfPOST /v1/keys/self/webhook-secretGET /v1/keys/verifyPOST /v1/keys/verifyPOST /v1/keys/verify/denyGET /v1/usagePOST /v1/x402/topup

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