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

# Get a withdrawal

> One USDC withdrawal and its current status.

Scope: `withdraw:funds`, granted on request · REST only, no MCP tool

Poll this after [Withdraw](https://catchbackcards.mintlify.site/partner-api/endpoints/create-withdrawal.md) until the status is `completed` or `failed`. A few seconds apart is plenty; most finish within minutes.

**id** `string` *required*

The withdrawal's `id`. A UUID.

## Response

**withdrawal** `object`

The fields of a withdrawal in [Withdraw](https://catchbackcards.mintlify.site/partner-api/endpoints/create-withdrawal.md).

| Status | Means |
| - | - |
| `processing` | Sent, or being sent |
| `pending_review` | Held for our review, usually cleared within one business day |
| `completed` | Arrived; `tx_hashes` are on Base |
| `failed` | Didn't go through; the amount is back in your balance |

## Errors

| Status | When |
| - | - |
| `400` | The id isn't a UUID |
| `403` | The key lacks `withdraw:funds` or isn't linked to an account |
| `404` | No withdrawal with that id on your account |

```bash cURL theme={null}
curl https://catchbackcards.com/api/partner/v1/withdrawals/3a6f1c2e-0000-4000-8000-000000000001 \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "withdrawal": {
    "id": "3a6f1c2e-…",
    "status": "completed",
    "amount": 2500,
    "fee": 0,
    "currency": "USDC",
    "destination": { "network": "USDC on Base", "address": "0xab12…ab12" },
    "tx_hashes": ["0x9c41…"],
    "failure_reason": null,
    "created_at": "2026-11-02T18:00:00.000Z",
    "completed_at": "2026-11-02T18:02:10.000Z"
  }
}
```


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