---
title: "Retrieve a purchased key after checkout (one-time, no auth required)"
method: GET
path: "/v1/keys/retrieve"
tags: ["Keys & Billing"]
---

# Retrieve a purchased key after checkout (one-time, no auth required)

`GET /v1/keys/retrieve`

## Request

- Base URL: `https://api.insumermodel.com`
- URL: `https://api.insumermodel.com/v1/keys/retrieve`
- Auth: none required

Called by the post-checkout redirect with the checkout `sessionId`. Returns the new key exactly once, then invalidates the retrieval — a second call returns 404. Waits briefly for payment confirmation before giving up. **Response envelope note**: standalone endpoint — flat `{success, key, ...}`.

## Query parameters

- `sessionId` string, required

## Response `200`

Key returned (shown once — save it now)

- object
  - `success` boolean
  - `key` string
  - `name` string
  - `tier` string
  - `dailyLimit` integer

## Other responses

- `400`: Missing or invalid sessionId
- `404`: Not found — payment may still be processing, or the key was already retrieved
- `405`: Method not allowed (only GET supported)
- `410`: Retrieval link expired — contact support
- `500`: Unexpected server error. Safe to retry; no credits are charged on a 500. Router endpoints return the standard error envelope; standalone endpoints (the ones whose 200 is a flat object) return a flat {"error": "..."} object.

---

[API](https://skmtc.dev/insumermodel/apis/insumerapi.md) · [All operations](https://skmtc.dev/insumermodel/apis/insumerapi/llms.txt) · [OpenAPI document](https://skmtc.dev/insumermodel/apis/insumerapi/revisions/91f56fe9e3d8?raw)