# GET /v4/ledger/earned/{address}

_Merkl API_

> What a recipient earned over a time window, prorated, per campaign and per token

### Path parameters

- `address` (string) _(required)_: Recipient address

### Query parameters

- `from` (string): Window start, unix seconds. Required.
- `to` (string): Window end, unix seconds. Defaults to now.
- `chainId` (string): Restrict to a single chain
- `campaignId` (string): Campaign id
- `token` (string): Reward token on `chainId`. Needs `chainId`.

## Responses

- **200** Response for status 200

## Example request

```bash
curl -X GET "https://api.merkl.xyz//v4/ledger/earned/{address}" \
  -H "x-api-key: YOUR_API_KEY"
```