---
title: "Cancelar un retiro de una cuenta conectada"
method: POST
path: "/connected_accounts/{connected_account_id}/withdrawals/{id}/cancel"
tags: ["connectedAccounts"]
deprecated: true
---

# Cancelar un retiro de una cuenta conectada

`POST /connected_accounts/{connected_account_id}/withdrawals/{id}/cancel`

## Request

- Base URL: `https://app.recurrente.com/api`
- URL: `https://app.recurrente.com/api/connected_accounts/{connected_account_id}/withdrawals/{id}/cancel`
- Auth: API key in header `X-SECRET-KEY`
- TypeScript: <https://skmtc.dev/recurrente/apis/referencia-api/docs/connected_accounts/:connected_account_id/withdrawals/:id/cancel/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

> **Obsoleto:** usa el endpoint unificado [`POST /transfers/{id}/cancel`](/api-reference/transfers/cancelar-un-movimiento) con `X-ACCOUNT-ID`. Este endpoint sigue funcionando para integraciones existentes.

## Path parameters

- `connected_account_id` string, required
- `id` string, required

## Response `200`

Retiro cancelado

- 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
  - `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
  - `recipient_email` string, nullable: Correo del beneficiario al que le avisamos el estado del retiro
  - `tracking_url` string, nullable: Página pública de seguimiento para el beneficiario
  - `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

## Other responses

- `422`: El retiro ya no puede cancelarse

## Changes

- **2026-09-19** `33bad9197d59`: 2 breaking
  - added `#/components/schemas/ErrorErrors0` to the `errors` response property `oneOf` list for the response status `422`
  - the `errors/oneOf[subschema #1 -> subschema #2]/` response's property type changed from `object` to `array` for status `422`
- **2026-09-17** `3d76463f9fd8`: 1 warning, 1 info
  - deleted the `header` request parameter `X-SECRET-KEY`
  - the endpoint scheme security `secretKey` was added to the API
- **2026-09-16** `3389210172a9`: 2 info
  - added the optional property `recipient_email` to the response with the `200` status
  - added the optional property `tracking_url` to the response with the `200` status
- **2026-09-12** `3f07af5cbba7`: 1 info
  - api operation id `cancel-connected-account-withdrawal` removed and replaced with `connectedAccounts_cancelConnectedAccountWithdrawal`

[Operation history](https://skmtc.dev/recurrente/apis/referencia-api/changes/connected_accounts/:connected_account_id/withdrawals/:id/cancel/post.md)

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) - [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recurrente/apis/referencia-api/revisions/1a3fc480dd94?raw)