---
title: "Poll a claim; delivers the key once after approval"
method: GET
path: "/api/agent/claims/{code}"
tags: ["Agent access"]
---

# Poll a claim; delivers the key once after approval

`GET /api/agent/claims/{code}`

## Request

- Base URL: `https://api.prereason.com`
- URL: `https://api.prereason.com/api/agent/claims/{code}`
- Auth: none required

Authorization: Bearer <claim_token>. Answers status pending (keep
polling every poll_interval seconds), approved with the api_key on the
first poll after approval, delivered on every later poll (no key in the
body), denied, or expired. An unknown code and a wrong token are the
same 404. 30 polls a minute per address.

## Path parameters

- `code` string, required

## Headers

- `Authorization` string, required

## Response `200`

The claim's status; on the first poll after approval, the key

- object
  - `status` 'pending' | 'approved' | 'delivered' | 'denied' | 'expired'
  - `claim_code` string
  - `api_key` string: Present once, on the first poll after approval
  - `delivered_once` boolean
  - `key` object
  - `account` object
  - `how_to_use` object
  - `approve_url` string
  - `expires_at` string, date-time
  - `poll_interval` integer
  - `error` string: KEY_ISSUE_FAILED when minting failed; poll again after retry_after seconds
  - `retry_after` integer
  - `message` string
  - `next` string
  - `docs` string

## Other responses

- `404`: CLAIM_NOT_FOUND (unknown code or wrong token, indistinguishable)
- `429`: RATE_LIMITED, with Retry-After

## Changes

- **2026-09-20** `0c21c73770c6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/prereason/apis/prereason-api/changes/api/agent/claims/:code/get.md)

---

[API](https://skmtc.dev/prereason/apis/prereason-api.md) - [All operations](https://skmtc.dev/prereason/apis/prereason-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prereason/apis/prereason-api/revisions/fe5bacbc7887?raw)