Listar movimientos de dinero

GET

https://app.recurrente.com/api/transfers

GET

/api/transfers

$ curl -G https://app.recurrente.com/api/transfers \
>      -H "X-SECRET-KEY: <apiKey>" \
>      -d from_time=2026-07-01 \
>      -d until_time=2026-07-31

200Retrieved

1 [
2   {
3     "id": "tr_nr4yplup",
4     "status": "completed",
5     "status_detail": "completed",
6     "amount_in_cents": 100,
7     "currency": "GTQ",
8     "fee_in_cents": 0,
9     "net_amount_in_cents": 100,
10     "note": "string",
11     "destination": {
12       "type": "bank_account",
13       "id": "string",
14       "bank_name": "string",
15       "holder_name": "string",
16       "currency": "string",
17       "name": "string",
18       "number": "string",
19       "address": "string",
20       "chain": "string",
21       "amount": 1
22     },
23     "created_at": "2024-01-15T09:30:00Z",
24     "sender": {
25       "id": "string",
26       "name": "string",
27       "type": "account"
28     },
29     "recipient": {
30       "id": "string",
31       "name": "string",
32       "type": "account"
33     }
34   }
35 ]

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 fecha de creación con from_time + until_time.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API

Query parameters

types[]list of enumsOptional

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

Allowed values:

account_idstringOptional

Lista los movimientos de una cuenta conectada (hija) en lugar de los tuyos

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.

Response

Lista unificada de movimientos

idstring

ID del movimiento (tr_ / wi_ / sw_)

statusenum

Estado canónico del movimiento

status_detailstring

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

amount_in_centsinteger

Monto en centavos debitado del balance

currencystring

Moneda del balance de origen

fee_in_centsinteger

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

net_amount_in_centsinteger

Monto neto que llega al destino después de comisiones

notestring or null

Nota del movimiento

destinationobject

Destino del movimiento. Los campos presentes dependen de type.

created_atdatetime

Fecha de creación

senderobject

(Solo registros tr_) Cuenta emisora — campo legado

recipientobject

(Solo registros tr_) Destinatario — campo legado