> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.crowdchange.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Heatmap

> Retrieve aggregated donation counts and amounts raised by country and state for a CrowdChange campaign, suitable for rendering a geographic heatmap.

## Path parameters

<ParamField path="id" type="integer" required>
  Fundraiser ID.
</ParamField>

## Response

Returns an array of objects with the following fields.

<ResponseField name="amount_raised" type="number">
  Total raised amount
</ResponseField>

<ResponseField name="n_donors" type="number">
  Number of donors
</ResponseField>

<ResponseField name="country" type="string">
  Country code
</ResponseField>

<ResponseField name="state" type="string">
  State or province.
</ResponseField>

**Other responses**

| Status | Description |
| ------ | ----------- |
| `400`  | Bad Request |
| `403`  | Forbidden   |

<ResponseExample>
  ```json theme={null}
  [
    {
      "amount_raised": 100,
      "n_donors": 10,
      "country": "CA",
      "state": "NY"
    }
  ]
  ```
</ResponseExample>