---
title: "Reward breakdowns of a single tree (BETA)"
method: GET
path: "/v4/historical/tree"
tags: ["Historical"]
---

# Reward breakdowns of a single tree (BETA)

`GET /v4/historical/tree`

**Historical Tree Breakdowns**<p>Returns the cumulative reward breakdowns of a single merkle tree, selected either by <code>date</code> (closest root on or before the date) or by an explicit <code>root</code> hash. Results can be filtered by <code>campaignId</code> and/or <code>recipient</code>.</p><p><strong>Authentication:</strong> Requires a valid API key passed via the <code>Authorization</code> header.</p><p>⚠️ <strong>Beta:</strong> this endpoint is in beta. The behavior, response shape and data format may change at any time without notice. Historical data is only available from the configured cutoff date onwards.</p>

## Query parameters

- `chainId` union, required
  - string, numeric
  - number
- `date` string — ISO date or unix timestamp. One of date or root is required.
- `root` string — Merkle root hash. One of date or root is required.
- `campaignId` string — Optional campaign filter
- `recipient` string — Optional recipient filter

## Response `200`

Response for status 200

- object
  - `root` string, required
  - `timestamp` string, required
  - `breakdowns` object[], required
    - `campaignId` string, required
    - `recipient` string, required
    - `reason` string, required
    - `rewardToken` string, required
    - `amount` string, required — Cumulative reward amount in the tree

---

[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)