# Verify Withdrawal

## Verify Withdrawal

<mark style="color:blue;">`GET`</mark> `https://api.cngn.co/v1/api/withdraw/verify/{tnxRef}`

Returns the full details of a withdrawal transaction by its reference.

#### Path Parameters

| Name                                     | Type   | Description                                                      |
| ---------------------------------------- | ------ | ---------------------------------------------------------------- |
| tnxRef<mark style="color:red;">\*</mark> | string | The transaction reference returned from the withdrawal endpoint. |

{% tabs %}
{% tab title="200 Transaction fetched successfully" %}

```json
{
  "status": 200,
  "message": "Transaction fetched successfully",
  "data": {
    "id": "clx1abc123def456",
    "from": "Convexity",
    "receiver": {
      "address": "0x5678901234abcdef5678901234abcdef56789012"
    },
    "amount": "10000.00",
    "description": "Withdrawal",
    "createdAt": "2025-06-15T10:30:00.000Z",
    "trx_ref": "WTH-20250615-ABC123",
    "trx_type": "withdraw",
    "network": "bsc",
    "asset_type": "cNGN",
    "asset_symbol": "CNGN",
    "base_trx_hash": "0xabc123def456789...",
    "extl_trx_hash": "0xdef456abc789012...",
    "explorer_link": "https://bscscan.com/tx/0xdef456abc789012...",
    "status": "completed"
  }
}
```

{% endtab %}

{% tab title="400 Invalid request" %}

```json
{
  "status": 400,
  "message": "Invalid request"
}
```

{% endtab %}
{% endtabs %}

#### Response Fields (Decrypted)

| Field           | Type        | Description                                 |
| --------------- | ----------- | ------------------------------------------- |
| `id`            | string      | Unique transaction identifier               |
| `from`          | string      | Sender identifier                           |
| `receiver`      | object      | Receiver wallet address                     |
| `amount`        | string      | Withdrawal amount                           |
| `description`   | string      | Transaction description                     |
| `createdAt`     | string      | ISO 8601 timestamp                          |
| `trx_ref`       | string      | Transaction reference                       |
| `trx_type`      | string      | Transaction type (`withdraw`)               |
| `network`       | string      | Blockchain network (see Networks Enum)      |
| `asset_type`    | string      | Asset type                                  |
| `asset_symbol`  | string      | Asset symbol                                |
| `base_trx_hash` | string/null | Base transaction hash                       |
| `extl_trx_hash` | string/null | External blockchain transaction hash        |
| `explorer_link` | string/null | Block explorer link for verification        |
| `status`        | string      | Transaction status (`pending`, `completed`) |

#### Example Request

```bash
curl -X GET https://api.cngn.co/v1/api/withdraw/verify/WTH-20250615-ABC123 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```
