# Delegator reward

The `DelegatorReward` entity offers a normalized representation of the Casper Network [Reward](https://docs.casper.network/concepts/glossary/R/#reward) related to the delegator account.

## Properties

The `DelegatorReward` entity contains the following properties:

| Property                       | Type         | Description                                                                                                                                                                                                |
| ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `delegator_identifier`         | `string(64)` | A representation of the delegator identifier, which can be either: a hex-encoded public key, or a purse URef, depending on `delegator_identifier_type_id`. Primary identifier                              |
| `delegator_identifier_type_id` | `uint8`      | Identifier representing the type of the delegator identifier: `0` for PublicKey, `1` for purse URef                                                                                                        |
| `public_key`                   | `string(64)` | The public key of the delegator account represented as a hexadecimal string. Primary account identifier (deprecated: use `delegator_identifier` instead, this property will be removed in future versions) |
| `validator_public_key`         | `string(64)` | Public key of the validator represented as a hexadecimal string. Unique validator identifier                                                                                                               |
| `era_id`                       | `uint32`     | Era identifier                                                                                                                                                                                             |
| `amount`                       | `uint64`     | Amount of the reward received by the delegator.                                                                                                                                                            |
| `timestamp`                    | `datetime`   | Timestamp indicating when the last block was proposed.                                                                                                                                                     |

**Example**

```json
{
  "amount": "44272516539",
  "delegator_identifier": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02",
  "delegator_identifier_type_id": 0,
  "era_id": 17997,
  "public_key": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02",
  "timestamp": "2025-05-22T07:03:50Z",
  "validator_public_key": "01fe8594026624b992c840281cb528515bd8574d281c38222deaa6eb22546c7656"
}
```

## Optional properties

Depending on the endpoint, the following optional properties may be included in the `DelegatorReward` entity:

| Property                   | Type                                                              | Description                                                                                                                                                                    |
| -------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `rate`                     | `float32`                                                         | The rate that was relevant at the moment when the last block was proposed. To get more details see [Including CSPR rates](/documentation/highlights/including-cspr-rates.md) . |
| `account_info`             | [`AccountInfo`](/rest-api/account-info.md)                        | [Account info](https://github.com/make-software/casper-account-info-contract) provided by the account owner                                                                    |
| `validator_account_info`   | [AccountInfo](/rest-api/account-info.md)                          | [Account info](https://github.com/make-software/casper-account-info-contract) provided by the validator                                                                        |
| `centralized_account_info` | [`CentralizedAccountInfo`](/rest-api/centralized-account-info.md) | Account information available for known accounts provided by CSPR.cloud team                                                                                                   |
| `cspr_name`                | `string`                                                          | Primary CSPR.name of the account                                                                                                                                               |
| `validator_cspr_name`      | `string`                                                          | Primary CSPR.name of the validator account                                                                                                                                     |

## Relations

The `DelegatorReward` entity has the following relations with other entities:

| Entity                                | Mapping property                                       | Description                                                                        |
| ------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| [`Account`](/rest-api/account.md)     | `delegator_identifier`, `delegator_identifier_type_id` | Accounts receive rewards for delegating to validators.                             |
| [`Purse`](/rest-api/purse-uref.md)    | `delegator_identifier`, `delegator_identifier_type_id` | Purses receive rewards for delegating to validators.                               |
| [`Validator`](/rest-api/validator.md) | `validator_public_key`                                 | Delegation rewards are associated with the validator, that distributed the rewards |

## Endpoints

The `DelegatorReward` entity has the following endpoints:

* [Get account delegation rewards](/rest-api/delegator-reward/get-account-delegation-rewards.md)
* [Get total account delegation rewards](/rest-api/delegator-reward/get-account-total-delegation-rewards.md)
* [Get purse delegation rewards](https://github.com/make-software/casper-middleware/blob/documentation/docs/public/rest-api/delegator-reward/get-purse-uref-delegation-rewards.md)
* [Get total purse delegation rewards](https://github.com/make-software/casper-middleware/blob/documentation/docs/public/rest-api/delegator-reward/get-purse-uref-total-delegation-rewards.md)
* [Get total validator delegators' rewards](/rest-api/delegator-reward/get-total-validator-delegators-rewards.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cspr.cloud/rest-api/delegator-reward.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.