---
title: "Claim status (Authorization: Bearer <verifySecret>)"
method: GET
path: "/claims/{id}"
tags: ["claims"]
---

# Claim status (Authorization: Bearer <verifySecret>)

`GET /claims/{id}`

## Request

- Base URL: `https://wellknown.network/api/v1`
- URL: `https://wellknown.network/api/v1/claims/{id}`
- Auth: one of:
  - none
  - HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

OK

- ClaimResponse
  - `claim` Claim
    - `id` string
    - `agent` object
      - `id` string
      - `handle` string
      - `url` string
    - `method` string
    - `target` string
    - `status` 'pending' | 'verified' | 'failed' | 'expired' | 'revoked'
    - `attempts` integer
    - `lastError` string, nullable
    - `expiresAt` string, date-time
    - `instructions` object
      - `title` string
      - `steps` string[]
      - `snippet` string
    - `verify` object
      - `url` string
      - `method` string
      - `authorization` string: Bearer <verifySecret>; shown only in the start response.

## Other responses

- `401`: Error
- `404`: Error

---

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