---
title: "Look up a key's account details (key in body, no header auth)"
method: POST
path: "/v1/keys/lookup"
tags: ["Keys & Billing"]
---

# Look up a key's account details (key in body, no header auth)

`POST /v1/keys/lookup`

## Request

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

Paste-your-key account lookup used by the developer account page. Returns a safe subset: name, tier, key suffix, owner email, credit balance, daily limit, usage counters, timestamps, expiry, whether the key has an active card subscription, and the `keyHash` used by /v1/keys/checkout and /v1/credits/topup. Rate-limited per client address (429 on abuse). **Response envelope note**: standalone endpoint — flat `{success, ...}`.

## Request body

- object
  - `key` string, required: The full insr_live_ key (50 chars).

## Response `200`

Account details

- object
  - `success` boolean
  - `name` string
  - `tier` string
  - `keySuffix` string
  - `ownerEmail` string
  - `apiKeyCredits` integer
  - `dailyLimit` integer
  - `totalRequests` integer
  - `totalAttestations` integer
  - `createdAt` string, date-time, nullable
  - `lastUsedAt` string, date-time, nullable
  - `hasStripe` boolean
  - `paidWithUsdc` boolean
  - `expiresAt` string, date-time, nullable
  - `rateLimitUsage` integer: Requests used in the current daily window.
  - `keyHash` string: Identifier for /v1/keys/checkout upgrades and /v1/credits/topup.

## Other responses

- `400`: Invalid key format
- `403`: Key deactivated or expired
- `404`: Key not found
- `405`: Method not allowed (only POST supported)
- `429`: Too many lookups — try again in a few minutes
- `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)