Listar retiros de una cuenta conectada

Deprecated

GET

https://app.recurrente.com/api/connected_accounts/:connected_account_id/withdrawals

GET

/api/connected_accounts/:connected_account_id/withdrawals

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

200Retrieved

1 [
2   {
3     "id": "wi_ab12cd34",
4     "status": "pending",
5     "amount_in_cents": 50000,
6     "currency": "GTQ",
7     "bank_name": "Banco Industrial",
8     "note": "string",
9     "created_at": "2024-01-15T09:30:00Z",
10     "bank_account": {
11       "id": "ba_lmgbvesmihkqzma3",
12       "bank_name": "Banco Industrial",
13       "holder_name": "Acme Restaurant, S.A.",
14       "created_at": "2024-01-15T09:30:00Z",
15       "status": "active",
16       "currency": "GTQ",
17       "account_type": "checking",
18       "is_preferred": true,
19       "ownership_type": "external"
20     }
21   }
22 ]

Obsoleto: usa el endpoint unificado GET /transfers con X-ACCOUNT-ID. Este endpoint sigue funcionando para integraciones existentes.

Lista los retiros de la cuenta conectada del más reciente al más antiguo. Filtra por fecha de creación con from_time + until_time.

> **Obsoleto:** usa el endpoint unificado [`GET /transfers`](/api-reference/transfers/listar-movimientos-de-dinero) con `X-ACCOUNT-ID`. Este endpoint sigue funcionando para integraciones existentes. Lista los retiros de la cuenta conectada del más reciente al más antiguo. Filtra por fecha de creación con `from_time` + `until_time`.

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.

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`.

Path parameters

connected_account_idstringRequired

Query parameters

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 de retiros

idstringOptional

statusenumOptional

amount_in_centsintegerOptional

currencystringOptional

bank_namestringOptional

notestring or nullOptional

Nota del retiro

created_atdatetimeOptional

bank_accountobjectOptional