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

# Get reward

> Get a single partner commission and its payout status

## Endpoint

```
GET https://api.partnero.com/v1/rewards/{id}
```

> [!NOTE]
>
> Affiliate programs only. In newsletter and refer-a-friend programs this endpoint returns `428`.

## Path parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | The reward's ID, e.g. `rwd_01jcx7m4q9v2k8t5r3n6w0ha1b`, as returned by [List rewards](https://docs.partnero.com/api-reference/rewards/list.md) or in a transaction's `rewards` array. The reward `key` isn't accepted |

## Request

```bash cURL theme={"system"}
curl --location 'https://api.partnero.com/v1/rewards/rwd_01jcx7m4q9v2k8t5r3n6w0ha1b' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

```json 200 OK theme={"system"}
{
  "data": {
    "id": "rwd_01jcx7m4q9v2k8t5r3n6w0ha1b",
    "key": "invoice_1001",
    "action": "sale",
    "status": "review_period",
    "customer": "customer_123",
    "partner": "partner_123",
    "amount": 200.0,
    "amount_units": "USD",
    "is_currency": true,
    "credit": false,
    "created_at": "2026-11-12T09:30:00.000000Z",
    "deleted_at": null,
    "product_type_data": [],
    "paid": false,
    "payout_status": "in_review",
    "transaction": "invoice_1001"
  },
  "status": 1
}
```

The fields are described in [List rewards](https://docs.partnero.com/api-reference/rewards/list.md#response-fields).

## Error responses

| Status | Error | Solution |
| - | - | - |
| 401 | Unauthenticated | Check your API key is set in the `Authorization` header |
| 404 | Reward not found | Check the ID belongs to a reward in this program. Archived rewards aren't returned |
| 428 | Rewards are not valid for this program type. They are only available for affiliate programs. | Use an API key of an affiliate program |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.