Listar movimientos del balance
Changed onLista el ledger de la cuenta, del movimiento más reciente al más antiguo: es la forma API del estado de cuenta descargable. Los montos son firmados: positivo acredita el balance y negativo lo debita.
amount_in_cents es el bruto y net_amount_in_cents es lo que efectivamente movió el balance; sumar fee_in_cents al bruto siempre da el neto. En un cobro, fee_details desglosa esa diferencia en la comisión y el IVA retenido, las mismas columnas del reporte descargable. balance_after_in_cents corresponde a la columna Balance de ese reporte.
Para conciliar un mes, filtra con from_time + until_time y sube items hasta 100. Cada par de fechas se envía completo: enviar solo una mitad devuelve 400 en vez de ignorar el rango.
No existe forma de preguntar qué cobros financiaron un retiro: Recurrente registra el débito del retiro y nada más, así que esa relación habría que inventarla. El camino inverso sí existe — cada movimiento en GET /api/transfers trae balance_transaction_id, la fila de ledger que registró.
Request
- Base URLhttps://app.recurrente.com/api
- AuthAPI key in header X-SECRET-KEY
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Inicio del rango de creación. Si se envía como fecha sin hora, se interpreta como el inicio del día. Se aplica solo junto con until_time.
Fin del rango de creación. Si se envía como fecha sin hora, se interpreta como el final del día. Se aplica solo junto con from_time.
Moneda del balance a consultar. Sin este filtro la lista mezcla todas las monedas de la cuenta.
Tipo contable del movimiento, por ejemplo charge, payout, refund o dispute.
Página a devolver. La respuesta trae los encabezados link, current-page, total-pages y total-count.
Elementos por página.
Response
Movimientos del balance
Changes
- breaking
added to the
response propertyoneOflist for the response status - breaking
the
/response's property type changed fromobjecttoarrayfor status
- breaking
- warning
deleted the
headerrequest parameterX-SECRET-KEY - info
the endpoint scheme security
secretKeywas added to the API
- warning