> ## 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.

# Decline reward

> Decline a commission that's in review so it's never paid out

## Endpoint

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

> [!NOTE]
>
> Affiliate programs only. In newsletter and refer-a-friend programs this endpoint returns `428`. Call it **server-side**, since it needs your secret API key.

Declines a reward that's waiting in the [commission review period](https://docs.partnero.com/knowledge-base/commissions-rewards/approve-or-reject-commission-in-review.md). This works the same way as clicking **Decline** in the dashboard. The reward's status changes from `review_period` to `declined`, its payout status becomes `declined` and it won't be paid out.

The call is safe to retry. Declining a reward that's already declined changes nothing and returns the reward as is.

> [!WARNING]
>
> Declining can't be undone through the API. Only rewards that are in review can be declined.

## Path parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | The reward's ID, e.g. `rwd_01jcx7m4q9v2k8t5r3n6w0ha1b` |

## Request

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

## Response

Returns the updated reward, in the same format as [Get reward](https://docs.partnero.com/api-reference/rewards/get.md).

```json 200 OK theme={"system"}
{
  "data": {
    "id": "rwd_01jcx7m4q9v2k8t5r3n6w0ha1b",
    "key": "invoice_1001",
    "action": "sale",
    "status": "declined",
    "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": "declined",
    "transaction": "invoice_1001"
  },
  "status": 1
}
```

## 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 |
| 422 | Only rewards in review can be approved or declined | The reward isn't in review, for example it was already approved. Check its `status` with [Get reward](https://docs.partnero.com/api-reference/rewards/get.md) |
| 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.