Listar movimientos de dinero
Lista unificada de todo el dinero que sale de tu balance, del más reciente al más antiguo: retiros bancarios (wi_), transferencias p2p (tr_) y envíos de stablecoin (sw_).
Filtra por tipo de destino con types[] y por cualquiera de las tres fechas de un retiro: creación (from_time + until_time), envío al banco (sent_from + sent_until) y liquidación bancaria confirmada (settled_from + settled_until).
sent_* y settled_* solo aplican a retiros bancarios, así que limitan la lista a bank_account; combinarlos con otros types[] devuelve 400. Cada par se envía completo: enviar solo una mitad devuelve 400 en vez de ignorar el rango.
Para conciliar depósitos, usa settled_* cuando el retiro tenga liquidación confirmada y sent_* en cualquier otro caso: hay rieles de envío que nunca confirman una liquidación y para esos settled_at siempre viene vacío.
Authentication
Tu clave secreta de API.
Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.
Query parameters
Filtra por tipo de destino: bank_account, account, phone_number, crypto_address
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.
Inicio del rango de envío al banco (sent_at). Limita la lista a retiros bancarios y se envía junto con sent_until.
Fin del rango de envío al banco. Si se envía como fecha sin hora, se interpreta como el final del día. Se envía junto con sent_from.
Inicio del rango de liquidación bancaria confirmada. Devuelve únicamente retiros confirmados o completados y se aplica solo junto con settled_until.
Fin del rango de liquidación bancaria confirmada. Si se envía como fecha sin hora, se interpreta como el final del día. Devuelve únicamente retiros confirmados o completados y se aplica solo junto con settled_from.
Elementos por página.
Response
ID del movimiento (tr_ / wi_ / sw_)
Estado canónico del movimiento
Estado crudo del registro subyacente (p. ej. approved, rejected, review_requested)
Comisión en centavos (retiros instantáneos / internacionales; 0 para p2p)
Monto neto que llega al destino después de comisiones
Correo del beneficiario al que le avisamos el estado del retiro. Solo aplica a movimientos wi_.
Página pública de seguimiento para el beneficiario (monto que recibe, cuenta enmascarada, estado y fecha estimada de llegada). Solo aplica a movimientos wi_; compártela con quien recibe el dinero.
Cuenta cuyo balance movió este envío. Siempre presente, para que una lista que abarca varias cuentas de una organización siga siendo atribuible.
Momento en que Recurrente envió el retiro al banco; solo aplica a retiros bancarios (wi_).
Momento de liquidación bancaria confirmada. Solo está presente para retiros bancarios confirmados o completados (wi_).
Referencia que devolvió el riel de envío, cuando ese riel devuelve una. Solo aplica a movimientos wi_; no identifica ni enumera transacciones que conformen el retiro.
Qué esperar de bank_reference: available si ya existe, pending si el retiro aún no sale y podría traerla, y unsupported si ya salió por un riel que nunca devuelve una. Con unsupported, concilia el depósito por statement_descriptor.
Lo que le pedimos al banco que imprima en el estado de cuenta del beneficiario. Solo aplica a movimientos wi_.
Fila del ledger que registró este movimiento (GET /api/balance_transactions/{id}). Vacío mientras el dinero no haya salido del balance.
Destino del movimiento. Los campos presentes dependen de type.
Fecha de creación
(Solo registros tr_) Cuenta emisora — campo legado
(Solo registros tr_) Destinatario — campo legado
ID del transfer original; solo aparece en reversos por reembolso
ID del reembolso que originó el reverso