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",
      "amountRequestedUsd": "50.000000",
      "amountPaidUsd": "50.000000",
      "feeUsd": "0.000000",
      "destinationChain": "arbitrum",
      "destinationAddress": "0x76F8fc6667E239f83a547d4e16225d6a34f6FA22",
      "destinationToken": "usdc",
      "status": "completed",
      "failureReason": null,
      "createdAt": "2025-09-05T10:00:00Z",
      "completedAt": "2025-09-05T10:05:00Z",
      "legsCompleted": 1,
      "legsTotal": 1,
      "payoutLegs": [
        {
          "from": {
            "kind": "cash",
            "id": "cash:arbitrum:usdc",
            "label": "Cash (Arbitrum)"
          },
          "to": {
            "kind": "external_payout",
            "id": "external_payout:arbitrum:usdc",
            "label": "External payout (Arbitrum)"
          },
          "status": "completed",
          "amountUsd": "50.000000",
          "startedAt": "2025-09-05T10:00:00Z",
          "completedAt": "2025-09-05T10:05:00Z",
          "stepsCompleted": 1,
          "stepsTotal": 1,
          "steps": [
            {
              "label": "Sending payout",
              "status": "completed",
              "txHash": "0x1234567890abcdef",
              "txStatus": "confirmed"
            }
          ]
        }
      ]
    }
  ],
  "nextCursor": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt

Use this file to discover all available pages before exploring further.

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 exact public status; repeat the parameter to match any of multiple statuses (OR semantics).

Available options:
processing,
completed,
partially_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.