Referencia APITransfers

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

X-SECRET-KEYstring
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. 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

types[]list of enumsOptional

Filtra por tipo de destino: bank_account, account, phone_number, crypto_address

Allowed values:
from_timedatetimeOptional

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.

until_timedatetimeOptional

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.

sent_fromdatetimeOptional

Inicio del rango de envío al banco (sent_at). Limita la lista a retiros bancarios y se envía junto con sent_until.

sent_untildatetimeOptional

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.

settled_fromdatetimeOptional

Inicio del rango de liquidación bancaria confirmada. Devuelve únicamente retiros confirmados o completados y se aplica solo junto con settled_until.

settled_untildatetimeOptional

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.

itemsintegerOptional1-100Defaults to 10

Elementos por página.

Response

Lista unificada de movimientos
idstringOptional

ID del movimiento (tr_ / wi_ / sw_)

statusenumOptional

Estado canónico del movimiento

status_detailstringOptional

Estado crudo del registro subyacente (p. ej. approved, rejected, review_requested)

amount_in_centsintegerOptional
Monto en centavos debitado del balance
currencystringOptional
Moneda del balance de origen
fee_in_centsintegerOptional

Comisión en centavos (retiros instantáneos / internacionales; 0 para p2p)

net_amount_in_centsintegerOptional

Monto neto que llega al destino después de comisiones

notestring or nullOptional
Nota del movimiento
account_idstringOptional

Cuenta cuyo balance movió este envío. Siempre presente, para que una lista que abarca varias cuentas de una organización siga siendo atribuible.

sent_atdatetime or nullOptional

Momento en que Recurrente envió el retiro al banco; solo aplica a retiros bancarios (wi_).

settled_atdatetime or nullOptional

Momento de liquidación bancaria confirmada. Solo está presente para retiros bancarios confirmados o completados (wi_).

bank_referencestring or nullOptional

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.

bank_reference_statusenum or nullOptional

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.

statement_descriptorstring or nullOptional

Lo que le pedimos al banco que imprima en el estado de cuenta del beneficiario. Solo aplica a movimientos wi_.

balance_transaction_idstring or nullOptional

Fila del ledger que registró este movimiento (GET /api/balance_transactions/{id}). Vacío mientras el dinero no haya salido del balance.

destinationobjectOptional

Destino del movimiento. Los campos presentes dependen de type.

created_atdatetimeOptional

Fecha de creación

senderobjectOptional

(Solo registros tr_) Cuenta emisora — campo legado

recipientobjectOptional

(Solo registros tr_) Destinatario — campo legado

reversal_of_idstringOptional

ID del transfer original; solo aparece en reversos por reembolso

refund_idstringOptional

ID del reembolso que originó el reverso