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

# Get withdrawal

> Retrieve a single merchant balance withdrawal by ID

## Overview

Returns one merchant withdrawal record for the authenticated merchant. Use this endpoint when you already have a withdrawal ID and need its latest state, timestamps, or transaction references.

> [!NOTE]
>
> The older `GET /v1/withdrawals/{id}` route still exists. This merchant-prefixed route is an alias added for consistency with `POST /v1/merchant/withdrawals`.

## Authentication

**X-Api-Key** `string` *required*

Your merchant API key

## Path Parameters

**id** `string` *required*

Withdrawal ID in UUID format.

**Example:** `550e8400-e29b-41d4-a716-446655440000`

## Request Examples

```bash cURL theme={"dark"}
curl --request GET \
  --url https://api.daya.co/v1/merchant/withdrawals/550e8400-e29b-41d4-a716-446655440000 \
  --header 'X-Api-Key: YOUR_API_KEY'
```

```javascript JavaScript theme={"dark"}
const response = await fetch(
  'https://api.daya.co/v1/merchant/withdrawals/550e8400-e29b-41d4-a716-446655440000',
  {
    headers: {
      'X-Api-Key': 'YOUR_API_KEY'
    }
  }
);

const withdrawal = await response.json();
console.log(withdrawal);
```

## Response

**id** `string`

Unique withdrawal identifier.

**amount\_usd** `string`

Withdrawal amount in USD.

**fee\_usd** `string`

Fee charged for the withdrawal, in USD.

**token** `string`

Token sent on-chain.

**chain** `string`

Destination chain.

**destination\_address** `string`

Recipient on-chain address.

**status** `string`

Current withdrawal status.

**Common values:** `PENDING`, `SUBMITTED`, `SETTLED`, `FAILED`

**provider\_tx\_id** `string`

Provider-side transfer identifier, when available.

**tx\_hash** `string`

On-chain transaction hash, when available.

**failure\_code** `string`

Failure code for unsuccessful withdrawals.

**failure\_message** `string`

Human-readable failure detail for unsuccessful withdrawals.

**created\_at** `string`

Time the withdrawal was created.

**submitted\_at** `string`

Time the withdrawal was submitted to the provider.

**settled\_at** `string`

Time the withdrawal was settled.

**updated\_at** `string`

Last update time for the withdrawal.

### Success Response

```json 200 OK theme={"dark"}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amount_usd": "12.3400",
  "fee_usd": "0.50",
  "token": "USDC",
  "chain": "SOLANA",
  "destination_address": "4vJ9JU1bJJE96FWSJN",
  "status": "SETTLED",
  "provider_tx_id": "transactions/abc123",
  "tx_hash": "4D5uX4exampleTxHash",
  "created_at": "2026-03-10T09:00:00Z",
  "submitted_at": "2026-03-10T09:01:00Z",
  "settled_at": "2026-03-10T09:03:00Z",
  "updated_at": "2026-03-10T09:03:00Z"
}
```

```json 404 Not Found theme={"dark"}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Withdrawal not found",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

## Error Responses

This endpoint may return:

* `400`: Invalid withdrawal ID format
* `401`: Unauthorized
* `404`: Withdrawal not found
* `500`: Internal server error

## Next Steps

> [card] [List Withdrawals](https://docs.daya.co/api-reference/merchant-balance/list-withdrawals.md)
>
> Browse recent withdrawals and paginate through history

> [card] [Create Withdrawal](https://docs.daya.co/api-reference/merchant-balance/withdraw-merchant-balance.md)
>
> Initiate another merchant balance withdrawal


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