Merkl Developer Portal logo
get

/v4/claims/history/{address}

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

Path parameters

addressstring
required

Recipient address

Query parameters

chainIdsstring (integer) | integer[]

Chain IDs to filter claims

Responses

200
Response for status 200
Schema
object[]
idstringClaim Id in Merkl Database
chainIdstring (integer) | integerChain Id the claim was detected on
recipientstringAddress of the recipient
blockNumbernumberBlock number at which the claim occurred
timestampnumberUnix timestamp of the claim
tokenstringToken address that was claimed
campaignIdstringCampaign ID associated with the claim
reasonstringReason for the claim
rootstringMerkle root used for the claim
amountstringAmount claimed (as string to handle big numbers)
metadataanyAdditional metadata about the claim
isLatestbooleanWhether this is the latest claim for this combination
Example
[
  {
    "id": "string",
    "chainId": 0,
    "recipient": "string",
    "blockNumber": 0,
    "timestamp": 0,
    "token": "string",
    "campaignId": "string",
    "reason": "string",
    "root": "string",
    "amount": "string",
    "metadata": null,
    "isLatest": false
  }
]