Find

GET

/api/user/balance-history

Este endpoint permite consultar o histórico de saldo do usuário autenticado. Ele retorna os registros das movimentações de saldo associadas ao usuário.

✅ Requisitos da Requisição

Método HTTP: GET

Endpoint: /api/user/balance-history

Content-Type: application/json

Autenticação: api_token

🧠 Header da requisição

Campo	Tipo	Obrigatório	Descrição
`x-api-key`	string	Sim	Token de autenticação API Key
`User-Agent`	AtivoB2B/1.0	Sim

Request

Header Params

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/api/user/balance-history' \
--header 'x-api-key: {Token}' \
--header 'User-Agent: AtivoB2B/1.0'

Response Example

200 - Success

{
  "message": "Histórico do saldo encontrado com sucesso.",
  "data": {
    "data": [
      {
        "id": "XXXX",
        "inflows": 0,
        "outflows": 1000,
        "total": 1000,
        "status": "REFUNDED",
        "description": null,
        "transactionId": "XXXX",
        "transactionFinancialReserveId": null,
        "anticipationId": null,
        "gatewayId": "XXXX",
        "sellerId": "XXXX",
        "createdAt": "2025-04-16T15:37:02.331Z"
      },
      {
        "id": "XXXX",
        "inflows": 100000,
        "outflows": 28000,
        "total": 72000,
        "status": "ANTICIPATION",
        "description": "Antecipação de recebíveis",
        "transactionId": null,
        "transactionFinancialReserveId": null,
        "anticipationId": "XXXX",
        "gatewayId": "XXXX",
        "sellerId": "XXXX",
        "createdAt": "2025-04-16T14:35:51.567Z"
      }
    ],
    "pages": 5,
    "page": 1,
    "limit": 10,
    "total": 48
  },
  "status": 200,
  "error": null
}

Modified at 2025-07-23 19:02:40

Find by ID

Summary

Find

✅ Requisitos da Requisição#

🧠 Header da requisição#

Request

Responses

✅ Requisitos da Requisição

🧠 Header da requisição