---
title: "GET /v4/claims/"
method: GET
path: "/v4/claims/"
tags: ["Claims"]
---

# GET /v4/claims/

`GET /v4/claims/`

Fetch claims filtered by chainId(s), recipient, campaignId, token, root, exact `reason`, and an inclusive `[fromTimestamp, toTimestamp]` range (Unix seconds). Scope by timestamp to keep responses light for recipients with many claims. Returns the 100 most recent claims unless a `recipient` is given, in which case all matching claims are returned.

## Query parameters

- `chainId` union — Single chain ID to filter claims (deprecated, use chainIds)
  - string, numeric
  - number — Single chain ID to filter claims (deprecated, use chainIds)
- `chainIds` union[] — Chain IDs to filter claims
  - union
    - string, numeric
    - number
- `recipient` string — Recipient EVM address (20 bytes, e.g. `0xabcd...`).
- `campaignId` string — Filter claims by **on-chain campaign ID** (32-byte hex hash, e.g. `0x93cf385c...`). NOT the internal `Campaign.id`. See [ID types](/integrate-merkl/id-types).
- `token` string — Token address to filter claims (20-byte EVM address).
- `root` string — Filter by root
- `reason` string — Exact match on the claim `reason` (e.g. `unclaimedRewards`).
- `fromTimestamp` union — Lower bound (inclusive) on the claim Unix timestamp, in seconds.
  - string, numeric
  - number — Lower bound (inclusive) on the claim Unix timestamp, in seconds.
- `toTimestamp` union — Upper bound (inclusive) on the claim Unix timestamp, in seconds.
  - string, numeric
  - number — Upper bound (inclusive) on the claim Unix timestamp, in seconds.

## Response `200`

Response for status 200

- object[]
  - `id` string, required — Claim Id in Merkl Database
  - `chainId` union, required — Chain Id the claim was detected on
    - string, numeric
    - number — Chain Id the claim was detected on
  - `recipient` string, required — Address of the recipient
  - `blockNumber` number, required — Block number at which the claim occurred
  - `timestamp` number, required — Unix timestamp of the claim
  - `token` string, required — Token address that was claimed
  - `campaignId` string, required — Campaign ID associated with the claim
  - `reason` string, required — Reason for the claim
  - `root` string, required — Merkle root used for the claim
  - `amount` string, required — Amount claimed (as string to handle big numbers)
  - `metadata` unknown, required
  - `isLatest` boolean, required — Whether this is the latest claim for this combination

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) · [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/merkl/merkl-api/revisions/a7e5b9f6fb5f/schema)