Transactions

List Transactions

• Endpoint: GET /v1/transaction

• Description: Lists transactions with optional filters and summary.

• Headers: Authorization: Bearer <accessToken>

• Query Params:

  Field	Type	Required	Description
  dateStart	string	No	YYYY-MM-DD (default: last 30 days)
  dateEnd	string	No	YYYY-MM-DD (default: today)
  profileId	string	No	Filter by profile
  transactionType	string	No	bet, prize, or refund
  pageIndex	number	No	Default 1
  pageSize	number	No	1 to 100

• Success Response (200):

{
  "status": "success",
  "data": [
    {
      "profileId": "507f1f77bcf86cd799439011",
      "roundId": "507f1f77bcf86cd799439055",
      "type": "bet",
      "amount": -2,
      "currency": "BRL",
      "balanceBefore": 100,
      "balanceAfter": 98,
      "metadata": {
        "gameModel": "oxe-ganhei",
        "betPrice": 2
      },
      "createdAt": "2025-01-02T12:00:00.000Z",
      "status": "completed",
      "processedAt": "2025-01-02T12:00:01.000Z"
    }
  ],
  "pagination": {
    "pageIndex": 1,
    "pageSize": 20,
    "totalCount": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  },
  "summary": {
    "totalBets": 2,
    "totalPrizes": 0,
    "totalRefunds": 0,
    "netRevenue": 2,
    "averageBetValue": 2,
    "totalTransactions": 1
  }
}

• Errors: 400, 401, 403, 500