---
title: "What the confirmation page shows: the request behind a link, without consuming it. A POST, so the token stays out of URLs and logs."
method: POST
path: "/v1/keys/verify/details"
tags: ["self-serve"]
---

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

`POST /v1/keys/verify/details`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/v1/keys/verify/details`
- Auth: none declared

## Request body

- VerifyTokenBody: Body of the `POST /v1/keys/verify*` calls: the token from the link.
  - `token` string, required: The single-use token from the emailed link (the `#t=` fragment, or the `?token=` query of a link sent before the fragment form).

## Response `200`

The request behind the link; nothing changes

- VerifyDetailsResponse: What the confirmation page shows before anyone presses a button.
  - `kind` string, required: `"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, required: What the owner is shown about one key request.
    - `app` string, nullable: The MapMap app the request SAID it came from (its label is one of the apps'), or `null` for any other label, which is never repeated.
    - `device` string, required: Coarse device class read from the user agent.
    - `requested_at` string, required: RFC 3339 time the key was requested.
    - `requested_at_text` string, required: The same time in words, UTC: "1 October 2026 at 14:05 UTC".
    - `source` string, required: One sentence for a person: "The request said it came from the MapMap Nav app." or "The request did not say which app it came from."
  - `state` string, required: The key's state: `provisional` until confirmed, `verified` once it is.

## Other responses

- `400`: Missing, unknown, used or expired token

---

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