Skip to main content
GET
/
v3
/
account
/
transactions
List Transactions
curl --request GET \
  --url https://api.oneclickdz.com/v3/account/transactions \
  --header 'X-Access-Token: <api-key>'
{
  "success": true,
  "data": {
    "items": [
      {
        "_id": "<string>",
        "type": "<string>",
        "operation": "<string>",
        "amount": 123,
        "oldBalance": 123,
        "newBalance": 123,
        "objid": "<string>",
        "note": "<string>",
        "time": "<string>"
      }
    ],
    "pagination": {
      "page": 123,
      "pageSize": 123,
      "totalPages": 123,
      "totalResults": 123
    }
  },
  "meta": {
    "timestamp": "<string>"
  }
}

​
Overview

Returns a paginated list of all transactions on your account, including deposits, withdrawals, top-ups, refunds, and transfers.

​
Query Parameters

​
page
integer
default:1
Page number (minimum: 1)
​
pageSize
integer
default:20
Items per page (minimum: 1, maximum: 100)
​
from
string
Start date for filtering (ISO 8601 format: 2025-10-01T00:00:00Z)
​
to
string
End date for filtering (ISO 8601 format: 2025-10-31T23:59:59Z)
When filtering by date, both from and to parameters must be provided together.

​
Transaction Types

​
Money In (Increment)

TypeDescription
DEPOSITMoney deposited to your account
REFUND-FLEXYRefund from failed mobile top-up
REFUND-ADSLRefund from failed internet top-up
REFUND-ORDERRefund from cancelled gift card order
RECEIVEMoney received from another user
POINT-EXCHANGEPoints converted to balance

​
Money Out (Decrement)

TypeDescription
FLEXYMobile top-up transaction
ADSLInternet top-up transaction
ORDERGift card or product order
WITHDRAWMoney withdrawn from account
SENDMoney sent to another user
SERVICEService payment or fee

​
Response

​
success
boolean
required
Indicates if the request was successful
​
data
object
required
​
meta
object
required

​
Examples

curl https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20 \
  -H "X-Access-Token: YOUR_API_KEY"

​
With Date Filtering

curl "https://api.oneclickdz.com/v3/account/transactions?from=2025-10-01T00:00:00Z&to=2025-10-31T23:59:59Z" \
  -H "X-Access-Token: YOUR_API_KEY"

​
Response Example

{
  "success": true,
  "data": {
    "items": [
      {
        "type": "FLEXY",
        "operation": "decrement",
        "oldBalance": 2316.129999998957,
        "amount": 990,
        "newBalance": 1326.129999998957,
        "objid": "68fe2cdd51bc170608683e3a",
        "note": "MIX1000_OOREDOO - 0554926570",
        "time": "2025-10-26T14:14:53.074Z",
        "_id": "68fe2cdd51bc170608683e40"
      },
      {
        "type": "REFUND-ORDER",
        "operation": "increment",
        "oldBalance": 316.1299999989569,
        "amount": 2000,
        "newBalance": 2316.129999998957,
        "objid": "68fcdd7cd712569c624e05ee",
        "note": "Refunded - 1 - 68fcdd7cd712569c624e05ee",
        "time": "2025-10-25T14:24:00.338Z",
        "_id": "68fcdd80d712569c624e069d"
      },
      {
        "type": "ORDER",
        "operation": "decrement",
        "oldBalance": 2316.129999998957,
        "amount": 2000,
        "newBalance": 316.1299999989569,
        "objid": "68fcdd7cd712569c624e05ee",
        "note": "Order - PSN Germany - 5€ - 1",
        "time": "2025-10-25T14:23:56.532Z",
        "_id": "68fcdd7cd712569c624e05f1"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 5,
      "totalPages": 105,
      "totalResults": 521
    }
  },
  "meta": {
    "timestamp": "2025-10-29T00:35:58.852Z"
  }
}

​
Use Cases

Transaction History

Display transaction history to users in your app

Accounting & Reports

Generate financial reports and statements

Balance Reconciliation

Verify balance changes and audit transactions

User Activity

Track user spending patterns and behavior

​
Best Practices

  • Always provide both from and to parameters - Use ISO 8601 format for dates - Set appropriate time ranges for reports - Consider timezone differences when filtering
  • Cache transaction data locally when possible - Use date filters to limit result sets - Implement proper pagination UI - Consider webhook notifications for real-time updates
  • Show transaction type in user-friendly language
  • Display amounts with proper currency formatting
  • Include timestamps in local timezone
  • Link transactions to related objects (top-ups, orders)

Get Balance

Check current account balance