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

# Get Payout

> Get details of a specific payout

Retrieve the full details and current status of a specific payout.

## Endpoint

`GET https://quickei.io/pay/sandbox/api/v1/payouts/{payout_id}`

## Path Parameters

<ParamField path="payout_id" type="string" required>
  The payout ID (e.g. `PYT-20260323-X4K9M2`)
</ParamField>

## Response Fields

| Field            | Description                                                                        |
| ---------------- | ---------------------------------------------------------------------------------- |
| `id`             | Unique payout identifier                                                           |
| `reference`      | Your internal reference                                                            |
| `amount`         | Payout amount                                                                      |
| `currency`       | ISO 4217 currency code                                                             |
| `fee`            | Fee charged for the payout                                                         |
| `total_deducted` | Total deducted from wallet (`amount` + `fee`)                                      |
| `status`         | `pending`, `processing`, `completed`, `failed`                                     |
| `recipient`      | Recipient details (type, account info)                                             |
| `description`    | Payout description                                                                 |
| `failure_reason` | Reason for failure (null unless `failed`)                                          |
| `processed_at`   | ISO 8601 timestamp when payout completed or failed (null while pending/processing) |
| `created_at`     | ISO 8601 timestamp of payout creation                                              |

## Example Request

```bash theme={null}
GET /merchant-api/pos/v1/payouts/PYT-20260323-X4K9M2
Authorization: Basic {base64_credentials}
```

## Success Response `200`

```json theme={null}
{
  "message": {
    "success": ["Payout details retrieved"]
  },
  "data": {
    "id": "PYT-20260323-X4K9M2",
    "reference": "PAY-2026-0042",
    "amount": 10000,
    "currency": "XAF",
    "fee": 200,
    "total_deducted": 10200,
    "status": "completed",
    "recipient": {
      "type": "mobile_money",
      "mobile_code": "237",
      "mobile_number": "670000000",
      "operator": "mtn"
    },
    "description": "Salary March 2026",
    "failure_reason": null,
    "processed_at": "2026-03-23T10:31:15+00:00",
    "created_at": "2026-03-23T10:30:00+00:00"
  }
}
```

## Error Response `404`

```json theme={null}
{
  "message": {
    "error": ["Payout not found"]
  }
}
```