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. Claims the caller may not read are omitted: private campaigns, hidden leaderboards and hidden reward tokens.

get/v4/claims/

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/
  • Auth: apiKey (a scheme the document does not define)

Query parameters

string numeric
OR
number

Single chain ID to filter claims (deprecated, use chainIds)

recipientstring

Recipient EVM address (20 bytes, e.g. 0xabcd...).

campaignIdstring

Filter claims by on-chain campaign ID (32-byte hex hash, e.g. 0x93cf385c...). NOT the internal Campaign.id. See ID types.

tokenstring

Token address to filter claims (20-byte EVM address).

rootstring

Filter by root

reasonstring

Exact match on the claim reason (e.g. unclaimedRewards).

string numeric
OR
number

Lower bound (inclusive) on the claim Unix timestamp, in seconds.

string numeric
OR
number

Upper bound (inclusive) on the claim Unix timestamp, in seconds.

Response

Response for status 200

idstring required

Claim Id in Merkl Database

recipientstring required

Address of the recipient

blockNumbernumber required

Block number at which the claim occurred

timestampnumber required

Unix timestamp of the claim

tokenstring required

Token address that was claimed

campaignIdstring required

Campaign ID associated with the claim

reasonstring required

Reason for the claim

rootstring required

Merkle root used for the claim

amountstring required

Amount claimed (as string to handle big numbers)

metadataunknown required
isLatestboolean required

Whether this is the latest claim for this combination

Changes

No recorded changes to this operation across all 36 revisions of this API.