---
title: "GET /v4/claims/history/{address}"
method: GET
path: "/v4/claims/history/{address}"
tags: ["Claims"]
---

# GET /v4/claims/history/{address}

`GET /v4/claims/history/{address}`

## Request

- Base URL: `https://api.merkl.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.merkl.xyz/v4/claims/history/{address}`
- Auth: `apiKey` (a scheme the document does not define)

Fetch a recipient's historical claims, grouped per claim transaction with amounts aggregated by token.

## Path parameters

- `address` string, required: Recipient address

## Query parameters

- `chainIds` union[]: Chain IDs to filter claims
  - union
    - string, numeric
    - number

## 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.dev/merkl/apis/merkl-api/revisions/60ffe2c7d887?raw)