Payout

Get payout history

GET/api/v1/mbiyopay/payout/history

Lists past MbiyoPay payouts initiated through this API.

Requires Authorization

ADMIN, ACCOUNTANT only

Session

Query parameters

`page`number	Defaults to 1.
`limit`number	Max 100. Defaults to 20.
`status`string	Filter by internal payout status.

Request

curl --request GET \
  --url https://api.swiftgoma.com/api/v1/mbiyopay/payout/history \
  --header 'Authorization: Bearer <access_token>'

200Example response

{
  "success": true,
  "data": {
    "payouts": [
      {
        "orderId": "SWG-OUT-1a2b3c4d5e6f7890",
        "transactionId": "txn_9c8d7e6f",
        "status": "pending",
        "amount": 50,
        "currency": "USD",
        "network": "airtel",
        "countryCode": "CD",
        "beneficiary": "Aline Mapendo"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}