Skip to main content

Documentation Index

Fetch the complete documentation index at: https://virtualsms.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

GET /api/v1/customer/transactions Returns a paginated list of account transactions — every balance movement. 
curl "https://virtualsms.io/api/v1/customer/transactions?limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Query parameters

NameDefaultDescription
type(all)Filter by transaction type (deposit, purchase, refund, credit)
from(none)ISO timestamp lower bound
to(none)ISO timestamp upper bound
limit50Page size (max 100)
offset0Pagination offset

​
Response

{
  "count": 142,
  "limit": 20,
  "offset": 0,
  "transactions": [
    {
      "id": "txn_abc123",
      "amount": -0.50,
      "type": "purchase",
      "description": "Telegram / GB",
      "order_id": "550e8400-e29b-41d4-a716-446655440000",
      "balance_before": 26.00,
      "balance_after": 25.50,
      "created_at": "2026-04-29T11:32:14Z"
    },
    {
      "id": "txn_def456",
      "amount": 25.00,
      "type": "deposit",
      "description": "USDT TRC20",
      "balance_before": 1.00,
      "balance_after": 26.00,
      "created_at": "2026-04-28T09:14:02Z"
    }
  ]
}

​
Notes

  • Negative amount = balance decrease (purchases). Positive amount = balance increase (deposits, refunds, credits).
  • order_id is set only on transactions tied to a specific order.
  • count is the total matching transactions across all pages, not just this page.