Finance

List balance movements

GET
/v1/balance/history

Authorization

selectkey<token>

API key para requisições autenticadas. Envie sua chave no cabeçalho selectkey (sandbox sk_test_…, produção sk_live_…).

In: header

Query Parameters

limit?integer
offset?integer
sort?string

Sort expression, e.g. "-createdAt"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/balance/history"
{
  "offset": 0,
  "limit": 0,
  "total": 5000,
  "page": {
    "offset": {
      "first": 0,
      "prev": 0,
      "next": 0,
      "last": 0
    },
    "current": 0,
    "total": 5000
  },
  "hasMore": true,
  "data": [
    {
      "id": 0,
      "fromType": "string",
      "toType": "string",
      "processedAmount": 5000,
      "oldBalance": {
        "availableBalance": 5000,
        "pendingBalance": 5000,
        "blockedBalance": 5000,
        "refundedBalance": 5000
      },
      "newBalance": {
        "availableBalance": 5000,
        "pendingBalance": 5000,
        "blockedBalance": 5000,
        "refundedBalance": 5000
      },
      "handledBy": "string",
      "createdAt": "string"
    }
  ],
  "merchant": {
    "name": "Acme Ltda",
    "merchantId": "string",
    "isSubAccount": true
  },
  "_links": {}
}
{
  "error": {
    "status": "Unauthorized",
    "statusCode": 401,
    "category": "authentication",
    "code": "unauthorized",
    "message": "Authentication is required to access this resource.",
    "resource": "server"
  }
}
{
  "error": {
    "status": "Forbidden",
    "statusCode": 403,
    "category": "authorization",
    "code": "forbidden",
    "message": "You do not have permission to perform this action.",
    "resource": "server"
  }
}
{
  "error": {
    "status": "Internal Server Error",
    "statusCode": 500,
    "category": "server",
    "code": "serverError",
    "message": "An unexpected error occurred. Please try again later.",
    "resource": "server",
    "details": "If the problem persists, contact support with the correlationId from the response headers."
  }
}