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

# Track a withdrawal

> Poll withdrawal status or receive the withdrawal.completed webhook.

## Track a withdrawal

After requesting a withdrawal, track its status by polling the API or by subscribing to the `withdrawal.completed` webhook.

## Poll withdrawal status

```typescript theme={null}
import { initialise } from '@prudra/core';
import { getWithdrawal, listWithdrawals } from '@prudra/wallet';

initialise({ apiKey: process.env.PRUDRA_API_KEY! });

// Get a specific withdrawal
const w = await getWithdrawal({ withdrawalId: 'wdr_clx1abc123' });
console.log(w.status);       // 'pending_conversion' | 'conversion_complete' | 'completed'
console.log(w.txHash);       // on-chain transfer hash
console.log(w.reference);    // your reference

// List all withdrawals
const history = await listWithdrawals();
for (const withdrawal of history) {
  console.log(`${withdrawal.id}  ${withdrawal.reference}  ${withdrawal.status}`);
}
```

Via cURL:

```bash theme={null}
curl https://api.prudra.dev/withdrawals/wdr_clx1abc123 \
  -H "Authorization: Bearer prv_test_sk_..."
```

## Status lifecycle

```mermaid theme={null}
stateDiagram-v2
    [*] --> pending_conversion: withdraw() called
    pending_conversion --> conversion_complete: Crypto sold for fiat
    conversion_complete --> completed: Bank wire received
    pending_conversion --> failed: On-chain tx failed
    conversion_complete --> failed: Wire failed (contact support)
    completed --> [*]
    failed --> [*]
```

| Status                | Meaning                                          | Typical duration  |
| --------------------- | ------------------------------------------------ | ----------------- |
| `pending_conversion`  | On-chain confirmed, waiting for crypto→fiat sale | 0–4 hours         |
| `conversion_complete` | Fiat ready, bank wire initiated                  | 1–3 business days |
| `completed`           | Wire received at destination bank                | Terminal          |
| `failed`              | Error — contact support with your reference      | Terminal          |

## Webhook notification

Register for `withdrawal.completed` to be notified when the bank wire arrives:

```typescript theme={null}
// Register once
curl -X POST https://api.prudra.dev/webhooks \
  -H "Authorization: Bearer prv_test_sk_..." \
  -d '{
    "url": "https://your-server.com/webhooks/prudra",
    "events": ["withdrawal.completed", "withdrawal.failed"]
  }'
```

`withdrawal.completed` payload:

```json theme={null}
{
  "type":    "withdrawal.completed",
  "eventId": "evt_clx1abc123",
  "payload": {
    "withdrawalId": "wdr_clx1abc123",
    "walletId":     "mwt_clx1abc123",
    "amount":       "100.00",
    "token":        "USDC",
    "reference":    "WD-001",
    "completedAt":  "2026-05-02T14:30:00.000Z"
  }
}
```

## Related

* [Request a withdrawal](/wallets/withdrawals/request) — initiating withdrawals
* [Webhooks overview](/webhooks/overview) — webhook setup and verification
* [Currencies and limits](/wallets/withdrawals/currencies) — fiat currency details