> ## 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. # List withdrawals > Returns a cursor-paginated list of withdrawals for a specific wallet. ## OpenAPI ````yaml swagger/swagger-combined.yaml GET /v2/wallets/{id}/withdrawals openapi: 3.0.0 info: title: Ground API description: Core API for portfolio wallets, deposits, withdrawals, and webhooks. version: 2.0.0 servers: - url: https://sandbox.groundtech.co - url: https://production.groundtech.co security: - bearerAuth: [] tags: - name: System description: System health and utility endpoints. - name: Sandbox Faucets description: Sandbox-only test token faucets. - name: Portfolio Wallets description: >- Portfolio wallets with strategy allocation, deposits, withdrawals, and yield positions. - name: Webhook Endpoints description: Webhook endpoint management for portfolio wallet notifications. paths: /v2/wallets/{id}/withdrawals: get: tags: - Portfolio Wallets summary: List wallet withdrawals description: Returns a cursor-paginated list of withdrawals for a specific wallet. operationId: listWalletWithdrawalsV2 parameters: - name: id in: path required: true schema: type: string format: uuid description: Wallet ID - name: cursor in: query required: false schema: type: string description: >- Opaque cursor from a prior response; pass it unchanged to fetch the next page (must be reused with the same filters and sort). - name: limit in: query required: false schema: type: integer default: 50 minimum: 1 maximum: 200 description: >- Maximum number of withdrawals to return in this response (smaller values reduce payload size and latency). - name: sort in: query required: false schema: type: string default: createdAt enum: - createdAt description: Field to sort by (currently only `createdAt` is supported). - name: order in: query required: false schema: type: string default: desc enum: - asc - desc description: >- Sort direction for results; use `desc` for newest-first or `asc` for oldest-first. - name: createdAtGte in: query required: false schema: type: string format: date-time description: >- Filter results to withdrawals created at or after this ISO-8601 timestamp. - name: status in: query required: false schema: type: array items: type: string enum: - processing - completed - partially_completed - failed - cancelled style: form explode: true description: >- Filter withdrawals by exact public status; repeat the parameter to match any of multiple statuses (OR semantics). responses: '200': description: Cursor-paginated list of withdrawals content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Withdrawal' nextCursor: type: string nullable: true description: >- Opaque cursor to fetch the next page, or null when there are no more results. example: 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: - name: Sending payout stepKind: external_payout_transfer sequenceRole: external_payout_transfer protocolType: external_payout stepOrdinal: 0 chain: arbitrum txKind: external_payout_transfer state: completed startedAt: '2025-09-05T10:00:00Z' completedAt: '2025-09-05T10:05:00Z' cancelledAt: null nextCursor: null '400': description: Invalid query parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_cursor: value: error: cursor is not compatible with the requested status filter code: invalid_cursor '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: Withdrawal: type: object properties: id: type: string format: uuid amountRequestedUsd: type: string nullable: true description: Requested withdrawal amount in USD as a formatted string. amountPaidUsd: type: string nullable: true description: >- Completed payout amount in USD as a formatted string. Null until at least one payout completes. feeUsd: type: string nullable: true description: Fee charged for the withdrawal as a formatted string. destinationChain: type: string description: Destination chain for the withdrawal. enum: - arbitrum - base - ethereum - ethereum_sepolia - polygon - solana - solana_devnet destinationAddress: type: string destinationToken: type: string enum: - usdc - usdt nullable: true status: type: string enum: - processing - completed - partially_completed - failed - cancelled description: >- Simplified withdrawal status. `partially_completed` means at least one payout leg delivered value and at least one leg failed or was cancelled. legsCompleted: type: integer legsTotal: type: integer payoutLegs: type: array items: $ref: '#/components/schemas/WalletWorkflowLeg' description: Source-to-destination payout workflow legs. failureReason: type: string nullable: true description: >- Human-readable reason for failure (only present when status is `failed`). createdAt: type: string format: date-time completedAt: type: string format: date-time nullable: true ErrorResponse: type: object required: - error - code properties: error: type: string description: >- Human-readable error message. May change without notice; do not parse programmatically. code: type: string description: >- Machine-readable error code. Stable across API versions — safe to switch on in client code. enum: - validation_error - unknown_parameters - unsupported_chain - unsupported_token - invalid_destination_address - precision_overflow - invalid_cursor - unauthenticated - forbidden - wallet_not_found - wallet_limit_reached - withdrawal_not_found - deposit_not_found - yield_source_not_found - wallet_projection_unavailable - insufficient_funds - duplicate_request_id - request_id_conflict - invalid_position_weight - invalid_withdrawal_plan - payout_not_found - webhook_not_found - webhook_duplicate_url - withdrawal_not_cancellable - withdrawal_already_cancelled - withdrawal_payout_in_progress - withdrawal_policy_required - workflow_conflict - payout_already_terminal - payout_in_progress - payout_not_retryable - address_book_entry_not_found - address_book_duplicate_entry - address_book_whitelist_violation - rate_limited - rate_limit_exceeded - internal_error - wallet_creation_failed - service_temporarily_unavailable WalletWorkflowLeg: type: object properties: status: type: string enum: - created - processing - pending_customer_approval - completed - failed - cancelled from: $ref: '#/components/schemas/WalletAccount' to: $ref: '#/components/schemas/WalletAccount' amountUsd: type: string nullable: true description: >- USD amount for this workflow leg. Null when no USD value is available. startedAt: type: string format: date-time nullable: true completedAt: type: string format: date-time nullable: true stepsCompleted: type: integer stepsTotal: type: integer steps: type: array items: $ref: '#/components/schemas/WorkflowStep' processingEstimate: $ref: '#/components/schemas/ProcessingEstimate' AuthErrorResponse: type: object required: - error properties: error: type: string description: Authentication or authorization error message. message: type: string nullable: true description: Additional auth middleware detail, when present. code: type: string nullable: true enum: - unauthenticated - forbidden description: >- Some auth and scope failures include a stable code; middleware errors may omit it. WalletAccount: oneOf: - type: object properties: kind: type: string enum: - yield_source id: type: string label: type: string - type: object properties: kind: type: string enum: - cash id: type: string label: type: string - type: object properties: kind: type: string enum: - external_payout id: type: string label: type: string - type: object properties: kind: type: string enum: - bridge id: type: string label: type: string - type: object properties: kind: type: string enum: - unknown id: type: string label: type: string WorkflowStep: type: object properties: name: type: string stepKind: type: string nullable: true sequenceRole: type: string nullable: true protocolType: type: string nullable: true stepOrdinal: type: integer chain: type: string nullable: true txKind: type: string nullable: true state: type: string enum: - created - processing - pending_customer_approval - completed - failed - cancelled startedAt: type: string format: date-time nullable: true completedAt: type: string format: date-time nullable: true cancelledAt: type: string format: date-time nullable: true ProcessingEstimate: oneOf: - type: object required: - basis - typicalCompletionDate - typicalWindowEndDate properties: basis: type: string enum: - banking_days typicalCompletionDate: type: string format: date typicalWindowEndDate: type: string format: date - type: object required: - basis - typicalMinDuration - typicalMaxDuration properties: basis: type: string enum: - elapsed_seconds typicalMinDuration: type: string description: ISO-8601 duration for the lower end of the usual window. typicalMaxDuration: type: string description: ISO-8601 duration for the upper end of the usual window. responses: Unauthorized: description: >- The request is missing a valid bearer token, or the token is invalid or expired. content: application/json: schema: $ref: '#/components/schemas/AuthErrorResponse' example: error: Unauthenticated request message: Missing or invalid bearer token TooManyRequests: description: >- Rate limit exceeded. Limits are enforced by API key/customer identity and by endpoint class. Retry with backoff; rate-limit headers are not currently emitted. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Rate limit exceeded code: rate_limited InternalServerError: description: >- An unexpected error occurred while processing the request. The request can be safely retried with the same `requestId`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Internal server error code: internal_error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````