> ## Documentation Index
> Fetch the complete documentation index at: https://developer.mouvlatam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /swaps/wallets/:walletId

> Eliminar una billetera de tu empresa por API (requiere habilitación)

Da de baja una billetera de tu empresa. La baja es **idempotente**: repetirla no falla.

**Scope requerido**: `SWAP` con el permiso **Gestionar billeteras**. Mismas condiciones que [`POST /swaps/wallets`](https://developer.mouvlatam.com/api-reference/swaps/create-wallet): gestión por API habilitada por Mouv para tu empresa, e IPs autorizadas en la llave. No requiere `Idempotency-Key`.

## Path

**walletId** `string` *required*

`id` de la billetera (ver [`GET /swaps/wallets`](https://developer.mouvlatam.com/api-reference/swaps/list-wallets)).

## Response 200

```json theme={null}
{
  "id": "5f0c2a64-7a5b-4d0e-9f3a-0c1d2e3f4a5b",
  "removed": true
}
```

Si la billetera ya estaba eliminada (por ti o por Mouv), responde `200` con `alreadyRemoved`:

```json theme={null}
{
  "id": "5f0c2a64-7a5b-4d0e-9f3a-0c1d2e3f4a5b",
  "removed": true,
  "alreadyRemoved": true
}
```

> [!NOTE]
>
> Las operaciones ya aceptadas **no se ven afectadas**: la dirección de entrega queda fijada al aceptar. Una billetera eliminada deja de aceptar cotizaciones nuevas y libera un cupo de las 20 vigentes. No libera el tope de 10 altas por API en 24 horas.

## Errores

| HTTP | `error` | Cuándo y qué hacer |
| - | - | - |
| 401 | `INVALID_API_KEY` | Llave inválida o revocada |
| 403 | `INSUFFICIENT_SCOPE` | La llave no es scope `SWAP` |
| 403 | `IP_NOT_ALLOWED` | La petición viene de una IP no autorizada para la llave |
| 403 | `WALLET_PERMISSION_REQUIRED` | La llave no tiene el permiso **Gestionar billeteras** |
| 403 | `IP_ALLOWLIST_REQUIRED` | La llave no tiene IPs autorizadas |
| 403 | `WALLET_API_NOT_ENABLED` | La gestión por API no está habilitada para tu empresa |
| 404 | `WALLET_NOT_FOUND` | La billetera no existe o es de otra empresa |
| 503 | `SWAP_UNAVAILABLE` | Reintenta con backoff |

```bash curl theme={null}
curl -X DELETE "https://consola.mouvlatam.com/api/swaps/wallets/5f0c2a64-7a5b-4d0e-9f3a-0c1d2e3f4a5b" \
  -H "Authorization: Bearer mvk_..."
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.