---
title: "Listar retiros"
method: GET
path: "/withdrawals"
tags: ["withdrawals"]
deprecated: true
---

# Listar retiros

`GET /withdrawals`

> **Deprecated.**

> **Obsoleto:** usa el endpoint unificado [`GET /transfers`](/api-reference/transfers/listar-movimientos-de-dinero) 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`.

## Query parameters

- `from_time` string, date-time
- `until_time` string, date-time

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Lista de retiros

- Withdrawal[]
  - `id` string
  - `status` 'pending' | 'approved' | 'in_review' | 'review_requested' | 'sent' | 'completed' | 'rejected' | 'cancelled'
  - `amount_in_cents` integer
  - `currency` string
  - `bank_name` string
  - `note` string, nullable — Nota del retiro
  - `created_at` string, date-time
  - `bank_account` BankAccount
    - `id` string — ID único de la cuenta bancaria
    - `bank_name` string, nullable — Nombre del banco
    - `holder_name` string — Nombre del titular
    - `created_at` string, date-time — Fecha de creación
    - `status` 'active' | 'archived' — Estado de la cuenta bancaria
    - `currency` 'GTQ' | 'USD' — Moneda de la cuenta bancaria
    - `account_type` 'checking' | 'savings' — Tipo de cuenta bancaria
    - `is_preferred` boolean — Indica si es la cuenta preferida para su moneda
    - `ownership_type` 'external' | 'virtual' — Tipo de cuenta bancaria

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/f494a078482c/schema)