Skip to main content

​
When to use

Use this endpoint to fetch a list of transactions for a specific wallet. You can filter the results by flow type (e.g., FUNDING) and paginate through the history.

​
Endpoint

  • GET {{LIQUIDITY_URL}}/v1/ext/wallet/:walletId/transactions
  • Auth: Bearer {{accessToken}}
  • Path param: walletId (the ID of the wallet to fetch transactions for)
  • Query params:
    • flowType: (Optional) Filter by transaction flow type (e.g., FUNDING).
    • limit: (Optional) Number of records per page (default: 10).
    • page: (Optional) Page number (default: 1).

​
Request

curl -X GET "{{LIQUIDITY_URL}}/v1/ext/wallet/{{walletId}}/transactions?flowType=FUNDING&limit=10&page=1" \
  -H "Authorization: Bearer {{accessToken}}"

​
Response (200)

{
    "data": [
        {
            "status": "SUCCESS",
            "flowType": "FUNDING",
            "timestamp": "2024-02-22T01:05:43.803Z",
            "method": "BANK_TRANSFER",
            "source": {
                "bankCode": "",
                "bankName": "Maplerad",
                "accountName": "Ms. Kitty Parisian DVM",
                "accountNumber": "0000000000"
            },
            "destination": {
                "transactionId": "3f3fa94b-e916-488e-8aed-64e0d2f2c37d",
                "owner": {
                    "id": "3e857814-91b1-4312-bb65-5e585227b6de",
                    "entityType": "BUSINESS"
                },
                "entry": "CREDIT",
                "walletId": "7b598ced-0464-47c4-94f2-da313c9f4066",
                "balance": "20472777.00",
                "currency": "NGN"
            },
            "amount": "101",
            "fees": "0.00",
            "total": "101"
        }
    ],
    "meta": {
        "page": 1,
        "pageSize": 10,
        "pageCount": 1,
        "total": 1
    }
}

​
Notes

  • The data array contains the list of transactions.
  • meta provides pagination details.