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