---
title: "Verify an account claim OTP"
method: POST
path: "/v1/auth/claim/verify"
tags: ["Account claim"]
---

# Verify an account claim OTP

`POST /v1/auth/claim/verify`

## Request

- Base URL: `https://api.chronary.ai`
- URL: `https://api.chronary.ai/v1/auth/claim/verify`
- Auth: API key in cookie `chronary_session`

Verifies the OTP for a pending claim. Requires console JWT auth with `iat` within the last 5 minutes — older sessions return 401 `reauth_required`. On success the claim enters a 24h revocation hold; the original account holder can revoke from the notification email during that window. After 24h a cron promotes the claim and transfers all org-scoped resources.

## Request body

- ClaimVerifyRequest
  - `claim_id` string, uuid, required
  - `otp` string, required

## Response `200`

Claim entered the 24h hold

- ClaimVerifyResponse
  - `claim_id` string, uuid, required
  - `status` 'verified', required
  - `revocation_window_ends_at` string, date-time, required
  - `expected_completion_at` string, date-time, required

## Other responses

- `400`: Validation error — invalid request body or query parameters
- `401`: Missing or invalid console session — these endpoints require a console JWT, not an API key.
- `500`: Internal server error

---

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