List Transfer History — GET /merchants/disbursements

Use this endpoint to browse and reconcile your complete transfer history. Results are paginated and can be filtered by status, recipient email, and date range to narrow down exactly the records you need.

GET https://sandbox.lyseis-pay.com/merchants/disbursements

Headers

Header	Value
`X-Key-Id`	Your merchant key ID
`X-Timestamp`	Unix timestamp of the request
`X-Signature`	HMAC request signature

Query parameters

string

Filter results by transfer status. Accepted values: processing, success, failed, reversed, expired.

string

Filter results to transfers sent to a specific recipient email address.

string

Return only transfers created on or after this date. Format: YYYY-MM-DD.

string

Return only transfers created on or before this date. Format: YYYY-MM-DD.

integer

default:"1"

Page number to retrieve. Defaults to 1.

integer

default:"10"

Number of records per page. Defaults to 10. Maximum is 100.

Example request

GET https://sandbox.lyseis-pay.com/merchants/disbursements?status=success&customer_email=ada@example.com&page=1&page_size=25

Example response

{
  "status": "success",
  "data": {
    "total": 134,
    "page": 1,
    "pageSize": 25,
    "data": [
      {
        "reference": "payout_12345",
        "destination_bank_code": "058",
        "destination_bank_account": "0123456789",
        "destination_bank_name": "Example Bank",
        "customer_name": "Ada Lovelace",
        "customer_email": "ada@example.com",
        "amount": 10000.00,
        "fee": 50.00,
        "currency": "NGN",
        "narration": "Merchant payout",
        "transfer_status": "success",
        "metadata": {
          "payout_id": "12345"
        },
        "created_at": "2026-01-15T10:00:00Z",
        "updated_at": "2026-01-15T10:02:30Z"
      }
    ]
  }
}

Response fields

integer

Total number of transfer records matching the applied filters (across all pages).

integer

The current page number returned.

integer

The number of records returned on this page.

array

Array of transfer records. Each record contains the following fields:

Show Transfer record fields

string

The unique reference assigned to this transfer.

string

Bank code of the recipient’s bank.

string

Recipient’s bank account number.

string

Name of the recipient’s bank.

string

Full name of the transfer recipient.

string

Email address of the transfer recipient.

number

Transfer amount.

number

Processing fee charged for this transfer.

string

ISO 4217 currency code.

string

The narration supplied when the transfer was initialized.

string

Current status of the transfer: processing, success, failed, reversed, or expired.

object

The metadata object supplied at initialization, if any.

string

ISO 8601 timestamp when the transfer was created.

string

ISO 8601 timestamp of the most recent status update.

Payments

Virtual Accounts

Direct Debits

Refunds

Transfers

Banks

List Transfer History — GET /merchants/disbursements

Query parameters

Example request

Example response

Response fields

​Query parameters

​Example request

​Example response

​Response fields

Query parameters

Example request

Example response

Response fields