Documentation menu
Keys and account
POST/v1/keys/verify/details
Access and price
| Auth | No key. Not metered. |
|---|---|
| Price | Not 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
| Field | Type | Required | Description |
|---|---|---|---|
| token | string | yes | The 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
| Field | Type | Required | Description |
|---|---|---|---|
| kind | string | yes | "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). |
| request | KeyRequestView | yes | What the request said about itself, when and roughly where. |
| state | string | yes | The 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
GET /.well-known/oauth-authorization-serverPOST /oauth/registerPOST /oauth/tokenPOST /v1/keysDELETE /v1/keys/selfGET /v1/keys/selfPOST /v1/keys/self/emailPOST /v1/keys/self/email/verifyPOST /v1/keys/self/verifyPOST /v1/keys/self/verify/resendGET /v1/keys/verifyPOST /v1/keys/verifyPOST /v1/keys/verify/denyGET /v1/usage
Generated from https://api.mapmap.ai/openapi.json on 2026-11-18 · operationId verify_details