Customer API

List transaction history

Returns a paginated list of account transactions — every balance movement (deposits, purchases, refunds, credits).

get/api/v1/customer/transactions

Request

  • Base URL: https://virtualsms.io
  • URL: https://virtualsms.io/api/v1/customer/transactions
  • Auth: API key in header X-API-Key

Query parameters

type'deposit' | 'purchase' | 'refund' | 'credit'

Filter by transaction type

fromstring date-time

ISO 8601 timestamp — earliest transaction to include

tostring date-time

ISO 8601 timestamp — latest transaction to include

limitinteger

Results per page (max 100, default 50)

offsetinteger

Pagination offset (default 0)

Response

Transaction list returned

countinteger

Total matching transactions across all pages

limitinteger
offsetinteger

Example response

{
  "count": 142,
  "limit": 20,
  "transactions": [
    {
      "id": "txn_abc123",
      "amount": -0.5,
      "type": "purchase",
      "description": "Purchase: Telegram ID number",
      "order_id": "550e8400-e29b-41d4-a716-446655440000",
      "balance_before": 26,
      "balance_after": 25.5,
      "created_at": "2024-02-24T12:05:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.