### Please Note

- Rewards payouts are based on complete **UTC days,** with one entry per validator/delegator each day.
- A minimum delegation of **100 ATOM** is required to start tracking a delegator.
- Data is available only from May 1, 2025, onward.

#### Network
- **Type**: string (required)
- Defaults to mainnet
- Description: The network to look up against

#### Type
- **Type**: string (enum) (required)
- Description: Specifies the role associated with the request.
- Allowed values: `delegator`, `validator`

#### Start Time
- **Type**: number (required)
- Description: Epoch-based start time for reward queries.

#### End Time
- **Type**: number (required)
- Description: Epoch-based end time for reward queries.

#### Addresses
- **Type**: array of strings (required)
- Description: List of addresses to retrieve rewards for.

#### Period
- **Type**: string (enum)
- Description: How the data is aggregated;
- Allowed values: `raw`, `daily`, `weekly`, `monthly`

#### Aggregate
- **Type**: boolean
- Defaults to false
- Description: Whether to aggregate across provided addresses or per address - true to aggregate across all addresses

#### Accept
- **Type**: string (enum)
- Defaults to application/json
- Description: Generated from available response content types
- Allowed values: `application/json`, `application/x-ndjson`

#### Response Codes
- `200` OK
- `400` Bad Request
- `422` Validation Error

#### Example cURL Request

```bash
curl --request POST \
     --url https://svc.blockdaemon.com/reporting/staking/v2/cosmos/mainnet/delegator/rewards \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"aggregate":false}'
```

### Response Examples
- application/x-ndjson
- `200`
- application/json
- `400`
- `422`