> ## 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`.
</Note>

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your merchant API key
</ParamField>

## Path Parameters

<ParamField path="id" type="string" required>
  Withdrawal ID in UUID format.

  **Example:** `550e8400-e29b-41d4-a716-446655440000`
</ParamField>

## Request Examples

<CodeGroup>
  ```bash cURL theme={null}
  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={null}
  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);
  ```
</CodeGroup>

## Response

<ResponseField name="id" type="string">
  Unique withdrawal identifier.
</ResponseField>

<ResponseField name="amount_usd" type="string">
  Withdrawal amount in USD.
</ResponseField>

<ResponseField name="fee_usd" type="string">
  Fee charged for the withdrawal, in USD.
</ResponseField>

<ResponseField name="token" type="string">
  Token sent on-chain.
</ResponseField>

<ResponseField name="chain" type="string">
  Destination chain.
</ResponseField>

<ResponseField name="destination_address" type="string">
  Recipient on-chain address.
</ResponseField>

<ResponseField name="status" type="string">
  Current withdrawal status.

  **Common values:** `PENDING`, `SUBMITTED`, `SETTLED`, `FAILED`
</ResponseField>

<ResponseField name="provider_tx_id" type="string">
  Provider-side transfer identifier, when available.
</ResponseField>

<ResponseField name="tx_hash" type="string">
  On-chain transaction hash, when available.
</ResponseField>

<ResponseField name="failure_code" type="string">
  Failure code for unsuccessful withdrawals.
</ResponseField>

<ResponseField name="failure_message" type="string">
  Human-readable failure detail for unsuccessful withdrawals.
</ResponseField>

<ResponseField name="created_at" type="string">
  Time the withdrawal was created.
</ResponseField>

<ResponseField name="submitted_at" type="string">
  Time the withdrawal was submitted to the provider.
</ResponseField>

<ResponseField name="settled_at" type="string">
  Time the withdrawal was settled.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Last update time for the withdrawal.
</ResponseField>

### Success Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "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={null}
  {
    "error": {
      "code": "NOT_FOUND",
      "message": "Withdrawal not found",
      "request_id": "550e8400-e29b-41d4-a716-446655440000"
    }
  }
  ```
</ResponseExample>

## Error Responses

This endpoint may return:

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

## Next Steps

<CardGroup cols={2}>
  <Card title="List Withdrawals" icon="list" href="/api-reference/merchant-balance/list-withdrawals">
    Browse recent withdrawals and paginate through history
  </Card>

  <Card title="Create Withdrawal" icon="paper-plane" href="/api-reference/merchant-balance/withdraw-merchant-balance">
    Initiate another merchant balance withdrawal
  </Card>
</CardGroup>