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

# GET /merchants/{merchantID}/withdrawals/{withdrawalID}

> Retrieve the details of a specific withdrawal order by ID, including its current state and on-chain transaction hash if available.

Use this endpoint to fetch the full details of a single withdrawal order. Poll this endpoint to track the status of a withdrawal as it progresses from `pending` through to final settlement.

<Info>
  Both Bearer token and API key authentication are accepted for this endpoint. API keys are scoped to a specific merchant — ensure the key matches the `merchantID` in the path.
</Info>

## Path parameters

<ParamField path="merchantID" type="string" required>
  The UUID of the merchant that owns the withdrawal.
</ParamField>

<ParamField path="withdrawalID" type="string" required>
  The UUID of the withdrawal order to retrieve.
</ParamField>

## Response

Returns a `200 OK` with the withdrawal object on success.

<ResponseField name="id" type="string">
  The UUID of the withdrawal order.
</ResponseField>

<ResponseField name="address" type="string">
  The destination wallet address the funds are being sent to.
</ResponseField>

<ResponseField name="amount" type="string">
  The withdrawal amount as a decimal string.
</ResponseField>

<ResponseField name="paymentMethodID" type="number">
  The ID of the payment method used for the transfer.
</ResponseField>

<ResponseField name="state" type="string">
  The current state of the withdrawal. Possible values include `pending`, `processing`, `completed`, and `failed`.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the withdrawal was created.
</ResponseField>

<ResponseField name="txHash" type="string">
  The on-chain transaction hash. Populated once the withdrawal has been broadcast to the network; `null` if not yet submitted.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.iterapay.com/merchants/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f/withdrawals/e3a1c2d4-f5b6-7890-abcd-ef1234567890 \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "e3a1c2d4-f5b6-7890-abcd-ef1234567890",
    "address": "TRR8WbHdkLBqNJAXmjS5jT4xEtd7X9bWb",
    "amount": "50.00",
    "paymentMethodID": 1,
    "state": "completed",
    "createdAt": "2024-01-15T10:30:00Z",
    "txHash": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
  }
  ```
</ResponseExample>