# Incentives

**URL:** https://heroiclabs.com/docs/hiro/python/incentives/
**Summary:** Manage sender and recipient incentives to encourage player interactions.
**Keywords:** incentives, hiro
**Categories:** hiro, python, incentives

---


# Incentives

*The Incentives system encourages social interactions and engagement through rewards for senders and recipients.* Learn more in the [Incentives concept guide](../../concepts/incentives/_index.md).

## Overview

Incentives enable your game to:

* Create and manage sender incentives.
* Allow recipients to claim incentives.
* Track incentive statuses and claims.

## Before You Start

Ensure that you have:

* Unity project configured with Hiro SDK.
* Nakama system integrated ([guide](../getting-started/_index.md)).

## Managing Sender Incentives

### Listing Sender Incentives

Retrieve all sender incentives for a player:

```py
incentives_list = await hiro_client.incentives_sender_list()
for incentive in incentives_list:
    for key, value in incentive.claims.items():
        print(f"{key} claimed at {value.claim_time_sec}.")

    for user_id in incentive.unclaimed_recipients:
        print(f"{user_id} has not yet claimed.")
```

### Creating Sender Incentives

Create a new sender incentive:

```py
request = IncentiveSenderCreateRequest()
request.id = "coin-invite"

result = await hiro_client.incentives_sender_create(request)
print(result.incentives[0].code)  # Code to share with another player
```

### Claiming Sender Incentives

Claim a sender incentive:

```py
request = IncentiveSenderClaimRequest()
request.code = code

result = await hiro_client.incentives_sender_claim(request)
```

### Deleting Sender Incentives

Delete an existing sender incentive:

```py
request = IncentiveSenderDeleteRequest()
request.code = code

result = await hiro_client.incentives_sender_delete(request)
```

## Managing Recipient Incentives

### Retrieving Recipient Incentives

Get information about a recipient incentive:

```py
request = IncentivesRecipientGetRequest()
request.code = code

result = await hiro_client.incentives_recipient_get(request)
```

### Claiming Recipient Incentives

Claim a recipient incentive reward:

```py
request = IncentiveRecipientClaimRequest()
request.code = code

result = await hiro_client.incentives_recipient_claim(request)
print(result.reward)
```