> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wellwallet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get withdrawal request list



## OpenAPI

````yaml /openapi.json get /withdrawal-requests
openapi: 3.0.3
info:
  description: API documentation for Crypto service
  title: Crypto API
  version: 1.0.0
servers:
  - description: Development
    url: https://tag.alfa-bot.com/api/prod/v1
security:
  - apiKeyAuth: []
tags:
  - description: Methods for working with wallets
    name: Wallets
  - description: Methods related to users
    name: User
  - description: Methods for AML verification
    name: AML
  - description: Test methods
    name: Test
  - description: Methods for withdrawal funds
    name: Withdrawal
  - description: Methods for working with transactions
    name: Transactions
  - description: Methods for working with exchange transactions
    name: Exchange
paths:
  /withdrawal-requests:
    get:
      tags:
        - Withdrawal
      summary: Get withdrawal request list
      operationId: getWithdrawalRequests
      parameters:
        - in: query
          name: request_id
          schema:
            type: string
          description: Withdrawal request ID filter.
        - in: query
          name: currency
          schema:
            type: string
          description: Currency/token filter.
        - in: query
          name: created_from
          schema:
            type: string
          description: Start date filter in ISO 8601 format.
        - in: query
          name: created_to
          schema:
            type: string
          description: End date filter in ISO 8601 format.
        - in: query
          name: network
          schema:
            type: string
          description: Network filter.
        - in: query
          name: status
          schema:
            type: string
          description: Status filter.
        - in: query
          name: external_id
          schema:
            type: string
          description: External request ID filter.
        - in: query
          name: sort_by
          schema:
            type: string
          description: Sort field.
        - in: query
          name: sort_direction
          schema:
            type: string
          description: 'Sort direction: asc or desc.'
        - in: query
          name: limit
          schema:
            type: string
          description: Pagination limit.
        - in: query
          name: offset
          schema:
            type: string
          description: Pagination offset.
      responses:
        '200':
          description: OK - withdrawal request list was returned successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - error_code
                  - error_message
                  - data
                properties:
                  code:
                    type: string
                    description: Response code.
                    example: '200'
                  error_code:
                    type: string
                    nullable: true
                    description: >-
                      Application-level error code. Null for successful
                      responses.
                    example: null
                  error_message:
                    type: string
                    nullable: true
                    description: >-
                      Human-readable error message. Null for successful
                      responses.
                    example: null
                  data:
                    type: object
                    properties:
                      success:
                        type: boolean
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/WithdrawalRequest'
                      meta:
                        $ref: '#/components/schemas/PaginationMeta'
              examples:
                success:
                  summary: Withdrawal request list
                  value:
                    code: '200'
                    error_code: null
                    error_message: null
                    data:
                      success: true
                      data:
                        - request_id: wd_6a16c48222d327108513784f
                          external_id: client_request_10001
                          amount: '100.00'
                          currency: USDT
                          network: trx
                          sender_wallet: TQv5p...9xA
                          recipient_wallet: TVx9...1bC
                          fee: '1.00'
                          status: new
                          comment: Client withdrawal
                          created_at: '2026-05-28T09:00:00.000Z'
                          updated_at: '2026-05-28T09:01:00.000Z'
                          transaction_status: confirmed
                          hash: >-
                            96fa587a6b44bcb1c2d17958b18d1b2bb89a5453d6be0098f8e1ea8dfe5b591b
                      meta:
                        limit: 30
                        offset: 0
                        total: 1
        '400':
          description: Bad Request - validation error or incorrect request parameters
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - error_code
                  - error_message
                  - data
                properties:
                  code:
                    type: string
                    description: Response code.
                    example: '400'
                  error_code:
                    type: string
                    nullable: true
                    description: >-
                      Application-level error code. Null for successful
                      responses.
                    example: request
                  error_message:
                    type: string
                    nullable: true
                    description: >-
                      Human-readable error message. Null for successful
                      responses.
                    example: Validation failed
                  data:
                    type: object
                    nullable: true
                    description: Additional error details when available.
                    additionalProperties: true
              examples:
                validation_error:
                  summary: Validation error
                  value:
                    code: '400'
                    error_code: request
                    error_message: 'Validation failed: invalid filter or pagination parameters'
                    data:
                      created_from: Must be valid ISO date
                      created_to: Must be valid ISO date
                      sort_by: Unsupported sort field
                      sort_direction: 'Allowed values: asc, desc'
        '500':
          description: Internal Server Error - unexpected server error
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - error_code
                  - error_message
                  - data
                properties:
                  code:
                    type: string
                    description: Response code.
                    example: '500'
                  error_code:
                    type: string
                    nullable: true
                    description: >-
                      Application-level error code. Null for successful
                      responses.
                    example: system
                  error_message:
                    type: string
                    nullable: true
                    description: >-
                      Human-readable error message. Null for successful
                      responses.
                    example: Validation failed
                  data:
                    type: object
                    nullable: true
                    description: Additional error details when available.
                    additionalProperties: true
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    code: '500'
                    error_code: system
                    error_message: Unexpected server error. Please try again later.
                    data: null
components:
  schemas:
    WithdrawalRequest:
      type: object
      properties:
        request_id:
          type: string
          example: wd_6a16c48222d327108513784f
        external_id:
          type: string
          example: client_request_10001
        amount:
          type: string
          example: '100.00'
        currency:
          type: string
          example: USDT
        network:
          type: string
          example: trx
        sender:
          type: string
          example: exchange
        sender_wallet:
          type: string
          example: TQv5p...9xA
        recipient_wallet:
          type: string
          example: TVx9...1bC
        fee:
          type: string
          example: '1.00'
        fee_included:
          type: boolean
          example: true
        status:
          type: string
          example: new
          enum:
            - new
            - awaiting_approval
            - completed
            - rejected
            - canceled
            - failed
        comment:
          type: string
          example: Client withdrawal
        created_at:
          type: string
          format: date-time
          example: '2026-05-28T09:00:00.000Z'
        updated_at:
          type: string
          format: date-time
          example: '2026-05-28T09:01:00.000Z'
        transaction_status:
          type: string
          nullable: true
          description: >-
            Status of the related blockchain transaction. Null when no linked
            transaction exists yet.
          enum:
            - in_progress
            - completed
            - error
          example: completed
        hash:
          type: string
          nullable: true
          description: >-
            Blockchain transaction hash. Null when the transaction has not been
            broadcast or confirmed yet.
          example: 96fa587a6b44bcb1c2d17958b18d1b2bb89a5453d6be0098f8e1ea8dfe5b591b
    PaginationMeta:
      type: object
      properties:
        limit:
          type: integer
          example: 30
        offset:
          type: integer
          example: 0
        total:
          type: integer
          example: 125
  securitySchemes:
    apiKeyAuth:
      in: header
      name: token
      type: apiKey
      description: Pass your API token in the `token` request header.

````