> For the complete documentation index, see [llms.txt](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/api-reference/openapi/v1-transaction-list.md).

# /v1/transaction/list

## Retrieve a list of transaction records

<mark style="color:yellow;">`GET`</mark> `/v1/transaction/list`

Fetches a paginated and optionally filtered list of transactions, including bets, wins, refunds, and other wallet movements. Useful for reporting, audits, and support operations.

**Headers**

| Name          | Value                |
| ------------- | -------------------- |
| Authorization | `Bearer <API_TOKEN>` |
| Content-Type  | `application/json`   |
| Accept        | `application/json`   |

**Parameters**

<table><thead><tr><th width="136">Key</th><th width="162">Data Type</th><th width="326">Description</th><th>Mandatory</th></tr></thead><tbody><tr><td>startTime</td><td>string (datetime)</td><td>Start time of the query range in <code>YYYY-MM-DD HH:mm:ss</code> format</td><td>Required</td></tr><tr><td>endTime</td><td>string (datetime)</td><td>End time of the query range in <code>YYYY-MM-DD HH:mm:ss</code> format</td><td>Required</td></tr><tr><td>offset</td><td>number</td><td>Number of records to skip for pagination</td><td>Required</td></tr><tr><td>limit</td><td>number</td><td>Maximum number of records to return</td><td>Required</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "total": 100,
    "offset": 0,
    "count": 100,
    "list": [
      {
        "transId": "1011520245",
        "transType": 1,
        "playerCode": 400000001,
        "playerExternalId": "demoplayer",
        "roundId": "12345713400010008",
        "providerId": 1,
        "providerName": "Pragmatic Play",
        "gameCode": "vswaysdogs",
        "gameName": "The Dog House Megaways",
        "amount": 5000,
        "balance": 40000,
        "success": true,
        "createdAt": "2022-12-28 12:00:00"
      }
    ]
  }
}
```

<table><thead><tr><th width="229">Key</th><th width="121">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>Indicates whether the request was processed successfully</td></tr><tr><td>message</td><td>string</td><td>Result message of the request</td></tr><tr><td>data</td><td>object</td><td>Transaction list response data</td></tr><tr><td>data.total</td><td>number</td><td>Total number of transactions matching the query</td></tr><tr><td>data.offset</td><td>number</td><td>Offset used for pagination</td></tr><tr><td>data.count</td><td>number</td><td>Number of records returned in the current response</td></tr><tr><td>data.list</td><td>array</td><td>List of transaction records</td></tr><tr><td>data.list[].transId</td><td>string</td><td>Unique transaction identifier</td></tr><tr><td>data.list[].transType</td><td>number</td><td>Transaction type (e.g., bet, win, cancel)</td></tr><tr><td>data.list[].playerCode</td><td>number</td><td>Unique player identifier in our API</td></tr><tr><td>data.list[].playerExternalId</td><td>string</td><td>Player identifier on the operator’s system</td></tr><tr><td>data.list[].roundId</td><td>string</td><td>Game round identifier</td></tr><tr><td>data.list[].providerId</td><td>number</td><td>Unique identifier of the game provider</td></tr><tr><td>data.list[].providerName</td><td>string</td><td>Display name of the game provider</td></tr><tr><td>data.list[].gameCode</td><td>string</td><td>Unique game code</td></tr><tr><td>data.list[].gameName</td><td>string</td><td>Display name of the game</td></tr><tr><td>data.list[].amount</td><td>number</td><td>Transaction amount</td></tr><tr><td>data.list[].balance</td><td>number</td><td>Player balance after the transaction</td></tr><tr><td>data.list[].success</td><td>boolean</td><td>Indicates whether the transaction is succeded.</td></tr><tr><td>data.list[].createdAt</td><td>string (datetime)</td><td>Transaction creation time in <code>YYYY-MM-DD HH:mm:ss</code> format</td></tr></tbody></table>