> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.recurrente.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server. # Listar retiros GET https://app.recurrente.com/api/withdrawals > **Obsoleto:** usa el endpoint unificado [`GET /transfers`](/referencia-api/api-reference/transfers/list-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`. Reference: https://docs.recurrente.com/referencia-api/api-reference/withdrawals/list-withdrawals ## Authentication - `X-SECRET-KEY` header (required) — 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`. ## Request ### Query parameters - `from_time` (datetime, optional) — 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_time` (datetime, optional) — 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 ### 200 Lista de retiros - `list of Withdrawal` ## Types ### Withdrawal Retiro bancario asíncrono. Para retiros locales, `sent` es un estado terminal exitoso; no esperes `completed` para continuar tu flujo. `completed` puede aparecer como confirmación adicional en retiros históricos o rails que la reportan. - `id` (string, optional) - `status` (enum, optional) - Allowed values: `pending`, `approved`, `in_review`, `review_requested`, `sent`, `completed`, `rejected`, `cancelled` - `amount_in_cents` (integer, optional) - `currency` (string, optional) - `bank_name` (string, optional) - `note` (string, optional, nullable) — Nota del retiro - `recipient_email` (string, optional, nullable) — Correo del beneficiario al que le avisamos el estado del retiro - `tracking_url` (string, optional, nullable) — Página pública de seguimiento para el beneficiario - `currency_conversion` (CurrencyConversion, optional, nullable) — 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_at` (datetime, optional) - `bank_account` (BankAccount, optional) ### CurrencyConversion - `id` (string, optional) - `status` (enum, optional) - Allowed values: `awaiting_confirmation`, `pending`, `processed`, `reverted` - `source_currency` (string, optional) - `source_amount_in_cents` (integer, optional) - `destination_currency` (string, optional) - `destination_amount_in_cents` (integer, optional) - `exchange_rate` (double, optional) - `expires_at` (datetime, optional, nullable) - `created_at` (datetime, optional) ### BankAccount - `id` (string, optional) — ID único de la cuenta bancaria - `bank_name` (string, optional, nullable) — Nombre del banco - `holder_name` (string, optional) — Nombre del titular - `created_at` (datetime, optional) — Fecha de creación - `status` (enum, optional) — Estado de la cuenta bancaria - Allowed values: `active`, `archived` - `currency` (enum, optional) — Moneda de la cuenta bancaria - Allowed values: `GTQ`, `USD` - `account_type` (enum, optional, nullable) — Tipo de cuenta bancaria - Allowed values: `checking`, `savings` - `is_preferred` (boolean, optional) — Indica si es la cuenta preferida para su moneda - `ownership_type` (enum, optional) — Tipo de cuenta bancaria - Allowed values: `external`, `virtual` ## Examples **Response** ```json [ { "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" } } ] ``` **SDK Code** ```python import requests url = "https://app.recurrente.com/api/withdrawals" querystring = {"from_time":"2026-07-01","until_time":"2026-07-31"} headers = {"X-SECRET-KEY": ""} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://app.recurrente.com/api/withdrawals?from_time=2026-07-01&until_time=2026-07-31'; const options = {method: 'GET', headers: {'X-SECRET-KEY': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://app.recurrente.com/api/withdrawals?from_time=2026-07-01&until_time=2026-07-31" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-SECRET-KEY", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://app.recurrente.com/api/withdrawals?from_time=2026-07-01&until_time=2026-07-31") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-SECRET-KEY"] = '' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://app.recurrente.com/api/withdrawals?from_time=2026-07-01&until_time=2026-07-31") .header("X-SECRET-KEY", "") .asString(); ``` ```php request('GET', 'https://app.recurrente.com/api/withdrawals?from_time=2026-07-01&until_time=2026-07-31', [ 'headers' => [ 'X-SECRET-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://app.recurrente.com/api/withdrawals?from_time=2026-07-01&until_time=2026-07-31"); var request = new RestRequest(Method.GET); request.AddHeader("X-SECRET-KEY", ""); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["X-SECRET-KEY": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://app.recurrente.com/api/withdrawals?from_time=2026-07-01&until_time=2026-07-31")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```