> For the complete documentation index, see [llms.txt](https://roqqu-api-services.gitbook.io/ras/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roqqu-api-services.gitbook.io/ras/transaction/token-withdrawals.md).

# Token Withdrawals

Retrieve token withdrawal (send) transactions for the authenticated merchant.

**Endpoint:** `GET /transaction/token-withdrawal`

**Authentication:** Required (`x-api-key` for live, `x-staging-api-key` for test)

#### **Example Request**

```
curl -X GET https://service.roqqu.com/v1/transaction/token-withdrawal \
  -H "x-api-key: YOUR_API_KEY"
```

#### **Example Response (Success)**

```
{
  "status": "success",
  "message": "withdrawals retrieved successfully",
  "data": [
    {
      "id": 1,
      "refid": "10704380386654367514",
      "checked": 0,
      "status": 0,
      "email": "merchant@business.com",
      "value": 1,
      "_to": "TUyR2sEjzDZNmbnac2ZkJ54h64m6TmVN71",
      "token": "usdt",
      "network": "trc20",
      "fee": 1,
      "contract": null,
      "tx_hash": null,
      "processed_at": null,
      "created_at": "2023-08-10T08:22:17.000Z",
      "updated_at": "2023-08-10T08:22:17.000Z"
    }
  ]
}
```

#### **Withdrawal status values**

| Status | Meaning                |
| ------ | ---------------------- |
| 0      | Pending                |
| 1      | Processing             |
| 2      | Failed                 |
| 3      | Completed successfully |
| 5      | Refund queued          |

`network` is the network code to parse (e.g. `trc20`, `bep20`).

#### **Error Responses**

**Invalid merchant:**

```
{
  "status": "fail",
  "message": "Invalid merchant"
}
```

**Merchant does not exist:**

```
{
  "status": "fail",
  "message": "Merchant does not exist"
}
```