> ## 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 payout request

> Retrieve a specific payout request by ID

## Endpoint

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

## Path parameters

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

## Request

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

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": 555,
      "partner": "partner_123",
      "status": "requested",
      "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:15:00.000000Z"
    },
    "status": 1
  }
  ```
</ResponseExample>

### Response fields

<Accordion title="Payout request — data">
  | Field | Type | Description |
  | - | - | - |
  | `id` | integer | Payout request ID |
  | `partner` | string | Partner ID |
  | `status` | string | Current [status](/api-reference/payout-requests/overview#status-values) |
  | `amount` | number | Payout amount |
  | `amount_units` | string | Payout currency, in lowercase |
  | `payout_gateway` | string | `paypal`, `wise`, `crypto` or `venmo` |
  | `created_by` | string | Where the request came from (`api`, `partner`, `automated_partner_payouts` and so on) |
  | `created_at` | string | ISO 8601 timestamp |
  | `updated_at` | string | ISO 8601 timestamp |
</Accordion>

## Error responses

| Status | Error | Solution |
| - | - | - |
| 404 | Payout request not found | Check the `id` is correct for this program |
| 422 | Validation error | `id` must be a positive integer |