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

# Approve payout request

> Approve a partner's payout request

## Endpoint

```
POST https://api.partnero.com/v1/payout_requests/{id}/approve
```

Approves a payout request, the same as approving it in the dashboard. The partner gets the approval email. If automated payouts are enabled for the program, the payout is then scheduled, and its status changes to one of the `*_scheduled` values.

Only requests with the status `requested`, `resubmitted` or `resubmit_requested` can be approved.

## Path parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | integer | Yes | Payout request ID |

No request body is needed.

## Request

```bash cURL theme={null}
curl --location --request POST 'https://api.partnero.com/v1/payout_requests/555/approve' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

Returns the updated payout request.

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": 555,
      "partner": "partner_123",
      "status": "approved",
      "amount": 200.0,
      "amount_units": "usd",
      "payout_gateway": "paypal",
      "created_by": "api",
      "created_at": "2026-09-29T10:15:00.000000Z",
      "updated_at": "2026-09-29T10:20:00.000000Z"
    },
    "status": 1
  }
  ```
</ResponseExample>

See [the payout request object](/api-reference/payout-requests/overview#the-payout-request-object) for the response fields.

## Error responses

| Status | Error | Solution |
| - | - | - |
| 404 | Payout request not found | Check the `id` is correct for this program |
| 422 | Payout request with status "finished" cannot be approved | Only `requested`, `resubmitted` and `resubmit_requested` requests can be approved |