Skip to main content

Get Statement API

Retrieves a detailed transaction history for your account.

  • URL: /v1/payment/statement

  • Method: GET

  • Auth Required: Yes

  • Success Response:

    {
      "status": 200,
      "message": "Transaction history fetched",
      "data": [
        {
          "id": 63,
          "client_id": "10302571",
          "validation_id": "6063542f-f212-40f0-95cd-52796b3839b7",
          "product_id": "10011",
          "trans_type": "PUSH",
          "trans_id": "f9ea82d2-458e-40a6-a578-1db8004f45ea",
          "reference_id": "e024d94f979f46e47acf51b1ab0bf6282124",
          "stellar_tx_id": null,
          "amount": "1000.0000000",
          "asset_code": "UGX",
          "currency": "UGX",
          "sender_account": "10302571",
          "receiver_account": "256711111111",
          "memo": "6063542f-f212-40f0-95cd-52796b3839b7",
          "status": "failed",
          "fee": "100.00",
          "service_name": "MOBILE_MONEY",
          "SessionId": "10280484",
          "created_at": "2025-04-16T06:09:55.000Z"
        }
      ]
    }

  • Error Response:

    {
      "status": 400,
      "message": "Failed to fetch transaction history",
      "data": null
    }

Response Fields​

  • id: Unique identifier for the transaction
  • client_id: Client identifier
  • validation_id: Unique validation identifier
  • product_id: Product identifier
  • trans_type: Type of transaction (PUSH, PULL, SWAP, BANK_DEPOSIT)
  • trans_id: Unique transaction identifier
  • reference_id: Client reference identifier
  • stellar_tx_id: Stellar transaction ID (if applicable)
  • amount: Transaction amount with precision up to 7 decimal places
  • asset_code: The code of the asset (e.g., UGX, cUGX)
  • currency: Currency code
  • sender_account: Account initiating the transaction
  • receiver_account: Account receiving the transaction
  • memo: Transaction memo or description
  • status: Transaction status (SUCCESS, PENDING, INITIATED, failed, MINT_FAILED)
  • fee: Transaction fee
  • service_name: Service provider name (e.g., MOBILE_MONEY)
  • SessionId: Session identifier
  • created_at: Transaction timestamp in ISO format

Transaction Types​

The API supports the following transaction types:

  • PUSH: Outgoing payment
  • PULL: Incoming payment/collection
  • SWAP: Currency exchange
  • BANK_DEPOSIT: Bank deposit transaction

Transaction Status​

Possible transaction status values:

  • SUCCESS: Transaction completed successfully
  • PENDING: Transaction is being processed
  • INITIATED: Transaction has been started
  • failed: Transaction failed
  • MINT_FAILED: Asset minting operation failed