Skip to content

Transactions Report ​

GET /api/client/reports/transactions

Retrieve a paginated list of transactions with optional filters. The response includes individual transaction records along with aggregated totals for debits, credits, rollbacks, free spins, and profit.

Query Parameters ​

ParameterTypeRequiredDescription
pageintegerNoPage number (default: 1)
filter[per_page]integerNoItems per page (default: 50)
filter[transaction_type][]stringNoFilter by type: DEBIT, CREDIT, ROLLBACK, FREE_SPIN
filter[currency_id]stringNoCurrency ISO code (e.g., USD, CRC)
filter[fromDate]stringNoStart date in YYYY-MM-DD format
filter[toDate]stringNoEnd date in YYYY-MM-DD format
filter[provider_id][]integerNoFilter by provider ID(s)

Filtering by Multiple Values

Array parameters (marked with []) accept multiple values. For example, to filter by both DEBIT and CREDIT types:

?filter[transaction_type][]=DEBIT&filter[transaction_type][]=CREDIT

Request ​

Headers ​

HeaderValueRequired
Acceptapplication/jsonYes
X-Client-SecretYour UUID secretYes

Request Example ​

bash
curl -X GET 'https://api.syssoft1.com/api/client/reports/transactions?page=1&filter[per_page]=50' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Example with Filters ​

bash
curl -X GET 'https://api.syssoft1.com/api/client/reports/transactions?page=1&filter[per_page]=50&filter[transaction_type][]=DEBIT&filter[currency_id]=USD&filter[fromDate]=2026-03-01&filter[toDate]=2026-04-13' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Response ​

Successful Response — 200 OK ​

json
{
  "data": [
    {
      "id": 12345,
      "type": "DEBIT",
      "amount": 10.00,
      "currency": "USD",
      "player": "player123",
      "provider": "Pragmatic Play",
      "game": "Sweet Bonanza",
      "created_at": "2026-04-13 10:30:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total": 150,
    "per_page": 50,
    "total_pages": 3
  },
  "totals": {
    "total_debit": {
      "raw": 50000.00,
      "formatted": "$50,000.00",
      "large_number": "50K",
      "count": 1200
    },
    "total_credit": {
      "raw": 45000.00,
      "formatted": "$45,000.00",
      "large_number": "45K",
      "count": 800
    },
    "total_rollback": {
      "raw": 500.00,
      "formatted": "$500.00",
      "large_number": "500",
      "count": 50
    },
    "total_free_spin": {
      "raw": 200.00,
      "formatted": "$200.00",
      "large_number": "200",
      "count": 100
    },
    "profit": {
      "raw": 4300.00,
      "formatted": "$4,300.00",
      "large_number": "4.3K"
    },
    "total_count": 2150
  }
}

Response Fields ​

data[] — Transaction Records ​

FieldTypeDescription
idintegerUnique transaction identifier
typestringTransaction type: DEBIT, CREDIT, ROLLBACK, or FREE_SPIN
amountnumberTransaction amount
currencystringCurrency ISO code
playerstringPlayer username
providerstringGame provider name
gamestringGame name
created_atstringTransaction timestamp (YYYY-MM-DD HH:mm:ss)

pagination — Pagination Information ​

FieldTypeDescription
current_pageintegerCurrent page number
totalintegerTotal number of records
per_pageintegerRecords per page
total_pagesintegerTotal number of pages

totals — Aggregated Totals ​

The totals object provides aggregated values across all records matching the current filters (not just the current page). Each monetary total includes:

FieldTypeDescription
rawnumberRaw numeric value
formattedstringFormatted string with currency symbol
large_numberstringAbbreviated representation (e.g., 50K, 1.2M)
countintegerNumber of transactions of this type

The profit field is calculated as: total_debit - total_credit - total_rollback.

Try It Out ​

⚡API PlaygroundGET

Parameters

pageinteger
Page number
filter[per_page]integer
Items per page
filter[transaction_type][]array
Transaction types
filter[currency_id]string
Currency ISO code
filter[fromDate]string
Start date (YYYY-MM-DD)
filter[toDate]string
End date (YYYY-MM-DD)
filter[provider_id][]array
Provider IDs

Request URL

https://api.syssoft1.com/api/client/reports/transactions

Error Responses ​

CodeDescription
401Invalid or inactive client secret. See Authentication.
422Invalid query parameters. Check parameter types and formats.
429Rate limit exceeded. Wait and retry. See Error Handling.

Client API Documentation