Skip to main content
GET
/
v2
/
wallets
/
{id}
/
withdrawals
List wallet withdrawals
curl --request GET \
  --url https://sandbox.groundtech.co/v2/wallets/{id}/withdrawals \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "w1a2b3c4-0000-4000-8000-000000000001",
      "amountUsd": "50.00",
      "feeUsd": "0.50",
      "destinationChain": "arbitrum",
      "destinationAddress": "0xRecipient...",
      "status": "completed",
      "txHash": "0xdef456...",
      "failureReason": null,
      "createdAt": "2025-09-05T10:00:00Z",
      "completedAt": "2025-09-05T10:05:00Z"
    }
  ],
  "nextCursor": null
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Wallet ID

Query Parameters

​
cursor
string

Opaque cursor from a prior response; pass it unchanged to fetch the next page (must be reused with the same filters and sort).

​
limit
integer
default:50

Maximum number of withdrawals to return in this response (smaller values reduce payload size and latency).

Required range: 1 <= x <= 200
​
sort
enum<string>
default:createdAt

Field to sort by (currently only createdAt is supported).

Available options:
createdAt
​
order
enum<string>
default:desc

Sort direction for results; use desc for newest-first or asc for oldest-first.

Available options:
asc,
desc
​
createdAtGte
string<date-time>

Filter results to withdrawals created at or after this ISO-8601 timestamp.

​
status
enum<string>[]

Filter withdrawals by status; repeat the parameter to match any of multiple statuses (OR semantics).

Available options:
pending,
processing,
completed,
failed,
cancelled

Response

Cursor-paginated list of withdrawals

​
data
object[]
​
nextCursor
string | null

Opaque cursor to fetch the next page, or null when there are no more results.