POST
/
wallets
/
account-number
/
history
curl --request POST \
  --url https://waas-staging.cafeone.ng/api/v1/wallets/account-number/history \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "accountNumber": "<string>",
  "from": "<string>",
  "to": "<string>"
}'

​
Request Body

​
accountNumber
string
required

The account number to retrieve transactions for.

Example: “211651123”

​
from
string
required

Start date and time for the transaction history period.

Example: “2025-03-19T17:11:52.488Z”

​
to
string
required

End date and time for the transaction history period.

Example: “2025-03-19T17:11:52.488Z”

​
Response


{
  "code": "200",
  "success": true,
  "message": "Transaction history retrieved successfully.",
  "data": {
    "accountNumber": "211651123",
    "currency": "NGN",
    "transactions": [
      {
        "transactionId": "TXN123456",
        "timestamp": "2025-03-19T17:11:52.488Z",
        "amount": 5000,
        "currency": "NGN",
        "transactionType": "credit",
        "paymentChannel": "Bank Transfer",
        "status": "successful",
        "description": "Salary Payment",
        "beneficiary": {
          "name": "John Doe",
          "accountNumber": "3020158746",
          "bank": "Zenith Bank"
        }
      },
      {
        "transactionId": "TXN654321",
        "timestamp": "2025-03-19T16:45:30.123Z",
        "amount": 2000,
        "currency": "NGN",
        "transactionType": "debit",
        "paymentChannel": "POS",
        "status": "pending",
        "description": "Grocery Shopping",
        "beneficiary": {
          "name": "ABC Supermarket",
          "accountNumber": "1234567890",
          "bank": "GTBank"
        }
      }
    ]
  }
}

​
❌ Error Responses

Status Code: 404 Not Found

{
  "code": "404",
  "success": false,
  "message": "Wallet not found",
  "data": null
}