Saltar al contenido principal
GET
/
v1
/
organizations
/
{organization_id}
/
ledgers
/
{ledger_id}
/
accounts
/
{account_id}
/
balances
/
history
Consultar historial de saldos por cuenta
curl --request GET \
  --url https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/balances/history
import requests

url = "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/balances/history"

response = requests.get(url)

print(response.text)
const options = {method: 'GET'};

fetch('https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/balances/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/balances/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/balances/history"

req, _ := http.NewRequest("GET", url, nil)

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/balances/history")
.asString();
require 'uri'
require 'net/http'

url = URI("https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/balances/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
[
  {
    "id": "019c96a0-0c0d-7915-84b9-e497bfee9916",
    "organizationId": "019c96a0-0a98-7287-9a31-786e0809c769",
    "ledgerId": "019c96a0-0ac0-7de9-9f53-9cf842a2ee5a",
    "accountId": "019c96a0-0c0c-7221-8cf3-13313fb60081",
    "alias": "@conta_corrente",
    "key": "default",
    "assetCode": "BRL",
    "available": "150000",
    "onHold": "25000",
    "version": 42,
    "accountType": "deposit",
    "direction": "credit",
    "overdraftUsed": "0",
    "settings": null,
    "position": {
      "available": "150000",
      "onHold": "25000",
      "overdraftLimitAvailable": "0"
    },
    "createdAt": "2025-06-01T10:00:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  },
  {
    "id": "019c96a0-1234-5678-9abc-def012345678",
    "organizationId": "019c96a0-0a98-7287-9a31-786e0809c769",
    "ledgerId": "019c96a0-0ac0-7de9-9f53-9cf842a2ee5a",
    "accountId": "019c96a0-0c0c-7221-8cf3-13313fb60081",
    "alias": "@conta_corrente",
    "key": "asset-freeze",
    "assetCode": "USD",
    "available": "50000",
    "onHold": "0",
    "version": 12,
    "accountType": "deposit",
    "direction": "credit",
    "overdraftUsed": "0",
    "settings": null,
    "position": {
      "available": "50000",
      "onHold": "0",
      "overdraftLimitAvailable": "0"
    },
    "createdAt": "2025-08-10T14:00:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
]

Encabezados

Content-Type
string

El tipo de medio del recurso. El valor recomendado es application/json.

X-Request-Id
string<uuid>

Un identificador único utilizado para rastrear y seguir cada solicitud.

Authorization
string

Token JWT bearer para autenticación. Requerido cuando PLUGIN_AUTH_ENABLED=true (obligatorio en despliegues multiinquilino). Opcional en el modo OSS de inquilino único predeterminado. Formato: Bearer <token>

Parámetros de ruta

organization_id
string<uuid>
requerido

El identificador único de la Organización asociada al Ledger.

ledger_id
string<uuid>
requerido

El identificador único del Ledger asociado.

account_id
string<uuid>
requerido

El identificador único de la cuenta.

Parámetros de consulta

date
string
requerido

La fecha y hora para consultar el estado del saldo. Formato: yyyy-mm-dd hh:mm:ss (ej.: 2026-01-15 10:30:00).

Pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene todos los estados de saldo en el momento especificado.

id
string<uuid>

El identificador único del Saldo.

organizationId
string<uuid>

El identificador único de la Organización.

ledgerId
string<uuid>

El identificador único del Ledger.

accountId
string<uuid>

El identificador único de la Cuenta.

alias
string

El alias de la cuenta (ej., @conta_corrente).

key
string

La clave única del saldo en el contexto de la cuenta (ej., default, asset-freeze).

assetCode
string

El código del activo (ej., BRL, USD).

available
string

El saldo disponible en el momento consultado. Representado como una cadena decimal con precisión arbitraria (ej., "1500.75").

onHold
string

El saldo retenido (reservado) en el momento consultado. Representado como una cadena decimal con precisión arbitraria (ej., "1500.75").

version
integer

La versión del saldo en el momento consultado.

accountType
string

El tipo de la cuenta (ej., deposit, creditCard).

direction
enum<string>

La dirección contable del saldo en el momento consultado.

Opciones disponibles:
credit,
debit
overdraftUsed
string

La cantidad de overdraft consumida en el momento consultado, como string decimal. Siempre no negativa.

settings
object

Snapshot de la configuración por saldo en el momento consultado. null para saldos legados sin configuraciones personalizadas.

position
object
read-only

Vista computada del estado del saldo en el momento consultado. Siempre presente; nunca persistida. Refleja la misma forma que la posición del saldo en vivo, así que las respuestas históricas llevan la misma estructura de wire que las lecturas en vivo.

createdAt
string<date-time>

Timestamp de creación del saldo (UTC).

updatedAt
string<date-time>

Timestamp de última actualización en el momento consultado (UTC).