---
title: "Get claim status"
method: GET
path: "/v1/claims/{request_id}"
tags: ["claims"]
---

# Get claim status

`GET /v1/claims/{request_id}`

Returns the current status of a previously submitted claim request.

The SDK polls this endpoint automatically with a 3-second interval. You only
need to call it directly if building a custom integration.

**Terminal statuses:** `completed`, `failed`, `timed_out`

## Path parameters

- `request_id` string, uuid, required

## Response `200`

Claim status

- ClaimStatus
  - `request_id` string, uuid
  - `status` 'received' | 'validating' | 'offsets_reserved' | 'building_tx' | 'tx_built' | 'submitting' | 'submitted' | 'awaiting_callback' | 'callback_received' | 'finalizing' | 'completed' | 'failed' | 'timed_out'
  - `variant` 'encrypted_balance' | 'public_balance'
  - `resolved_variant` string, nullable — Specific on-chain instruction variant selected by preflight validator.
  - `tx_signature` string, nullable — Solana transaction signature of the claim instruction.
  - `callback_signature` string, nullable — Solana transaction signature of the Arcium MPC callback.
  - `computation_account` string, nullable — Base58-encoded computation account address.
  - `failure_reason` string, nullable — Error message if status is failed.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404` — Claim not found
- `500` — Internal server error

---

[API](https://skmtc.net/umbra-defi/apis/umbra-relayer-api.md) · [All operations](https://skmtc.net/umbra-defi/apis/umbra-relayer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/umbra-defi/umbra-relayer-api/versions/d973e56013e5/schema)