---
title: "Check the proof now; success may return an owner API key once"
method: POST
path: "/claims/{id}/verify"
tags: ["claims"]
---

# Check the proof now; success may return an owner API key once

`POST /claims/{id}/verify`

## Request

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

## Path parameters

- `id` string, required

## Response `200`

OK

- ClaimVerifyResponse
  - `verified` boolean
  - `error` string
  - `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.
  - `apiKey` object: Present once, on the first successful verification of an anonymous claim.
    - `plaintext` string
    - `prefix` string
    - `scopes` string[]
    - `note` string

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