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

# Config Stats

> Fetch aggregate donation stats for a config you own

<Badge icon="shield" color="purple" shape="pill">
  Requires <span style={{ color: '#7E22CE', fontWeight: '800' }}>partner</span> scope
</Badge>

Returns aggregate donation stats for a single config owned by your developer project. This includes volumes broken down by chain and token.

## Get config stats

`GET /configs/{configId}/stats`

```bash theme={null}
curl https://www.donate.gg/api/v1/configs/0x1234...abcd/stats \
  -H "donate-api-key: YOUR_API_KEY"
```

**Path parameters**

| Parameter  | Description                                   |
| ---------- | --------------------------------------------- |
| `configId` | The config ID (hex string or base58 encoding) |

**Response**

```json theme={null}
{
  "channels": {
    "1": { "0xA0b8...": "1000000000000000000" },
    "101": { "So11...": "500000000" }
  },
  "usdDonatedE6": "150000000",
  "donationCount": "42",
  "firstDonationDate": "2025-01-15T12:00:00.000Z",
  "lastDonationDate": "2026-04-20T18:30:00.000Z"
}
```

| Field               | Type           | Description                                                                              |
| ------------------- | -------------- | ---------------------------------------------------------------------------------------- |
| `channels`          | object         | `{ [chainId]: { [tokenAddress]: totalGrossAtomicVolume } }`. Amounts are atomic strings. |
| `usdDonatedE6`      | string         | Total USD donated × 10^6                                                                 |
| `donationCount`     | string         | Total number of donations                                                                |
| `firstDonationDate` | string \| null | ISO 8601 timestamp of first donation, or `null`                                          |
| `lastDonationDate`  | string \| null | ISO 8601 timestamp of most recent donation, or `null`                                    |

**Error responses**

| Status | Code               | Description                                              |
| ------ | ------------------ | -------------------------------------------------------- |
| `400`  | `VALIDATION_ERROR` | Invalid config ID format                                 |
| `403`  | `SCOPE_DENIED`     | The `partner` scope is not enabled for your organization |
| `403`  | `FORBIDDEN`        | Config does not belong to this developer project         |
| `404`  | `NOT_FOUND`        | No config found with the given ID                        |