Transactions

List transactions received by the calling application

Changed on

Returns all transactions where the receiver tag belongs to the calling application. Sorted by createdAt descending.

get/v1/transactions/received

Request

Query parameters

pageinteger
sizeinteger
sortstring[]

Response

Paginated list of received transactions

successboolean
messagestring
errorCodestring
errorsstring[]
timestampstring date-time

Example response

{
  "data": {
    "content": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "reference": "TXN-16820000-AB1C2D3E",
        "senderTag": "@alice",
        "senderAppName": "WalletApp",
        "receiverTag": "@bob",
        "receiverAppName": "PaymentsApp",
        "amount": 1500,
        "currency": "NGN",
        "status": "AWAITING_ACCEPTANCE",
        "narration": "School fees payment",
        "webhooks": [
          {
            "transactionReference": "TXN-16820000-AB1C2D3E",
            "targetUrl": "https://app-b.example.com/webhooks/transactions",
            "eventType": "TRANSACTION_INITIATED"
          }
        ]
      }
    ]
  }
}

Changes