Listar retiros

Deprecated

GET

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

GET

/api/withdrawals

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

200Retrieved

[
  {
    "id": "wi_ab12cd34",
    "status": "pending",
    "amount_in_cents": 50000,
    "currency": "GTQ",
    "bank_name": "Banco Industrial",
    "note": "string",
    "recipient_email": "maria@example.com",
    "tracking_url": "https://app.recurrente.com/t/3xK9mPq2vLn8RtWz4Yb7Hc",
    "currency_conversion": {
      "id": "cu_ab12cd34",
      "status": "awaiting_confirmation",
      "source_currency": "USD",
      "source_amount_in_cents": 10000,
      "destination_currency": "GTQ",
      "destination_amount_in_cents": 75000,
      "exchange_rate": 7.5,
      "expires_at": "2024-01-15T09:30:00Z",
      "created_at": "2024-01-15T09:30:00Z"
    },
    "created_at": "2024-01-15T09:30:00Z",
    "bank_account": {
      "id": "ba_lmgbvesmihkqzma3",
      "bank_name": "Banco Industrial",
      "holder_name": "Acme Restaurant, S.A.",
      "created_at": "2024-01-15T09:30:00Z",
      "status": "active",
      "currency": "GTQ",
      "account_type": "checking",
      "is_preferred": true,
      "ownership_type": "external"
    }
  }
]

Obsoleto: usa el endpoint unificado GET /transfers con types[]=bank_account. Este endpoint sigue funcionando para integraciones existentes.

Lista los retiros 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.

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

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

recipient_emailstring or nullOptional

Correo del beneficiario al que le avisamos el estado del retiro

tracking_urlstring or nullOptional

Página pública de seguimiento para el beneficiario

currency_conversionobject or nullOptional

La conversión que pagó el retiro cuando el balance de origen está en otra moneda que la cuenta bancaria (por ejemplo, de tu balance en USD a una cuenta en GTQ). source_amount_in_cents es lo que salió de tu balance; amount_in_cents del retiro es lo convertido. null si no hubo conversión. Si el retiro se rechaza o se cancela dentro de las 72 horas, la conversión pasa a reverted y el monto vuelve a tu balance en la moneda de origen.

created_atdatetimeOptional

bank_accountobjectOptional