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

# List withdrawals

> Retrieves a paginated list of withdrawal transactions for a user, with optional filters.



## OpenAPI

````yaml /api-reference/openapi.json get /api/crypto/{userId}/withdraws
openapi: 3.1.0
info:
  title: LootRush Partner API
  description: >-
    REST endpoints for LootRush partner integrations: crypto withdrawals,
    transaction history, and OAuth-style user data access.
  version: 1.0.0
servers:
  - url: https://third-party.lootrush.com
    description: Third-party API (Withdraw, Connect)
  - url: https://history-api.lootrush.com
    description: History API
security:
  - bearerAuth: []
paths:
  /api/crypto/{userId}/withdraws:
    get:
      tags:
        - Withdrawals
      summary: List withdrawals
      description: >-
        Retrieves a paginated list of withdrawal transactions for a user, with
        optional filters.
      operationId: listWithdrawals
      parameters:
        - name: userId
          in: path
          required: true
          description: Unique identifier of the user whose withdrawals to retrieve.
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: Page number (1-indexed).
          schema:
            type: integer
            default: 1
        - name: perPage
          in: query
          description: Results per page.
          schema:
            type: integer
            default: 20
            maximum: 200
        - name: bulkId
          in: query
          description: Filter by bulk payment ID.
          schema:
            type: string
            format: uuid
        - name: transactionHash
          in: query
          description: Filter by blockchain transaction hash.
          schema:
            type: string
        - name: status
          in: query
          description: Filter by withdrawal status.
          schema:
            type: string
            examples:
              - queued
              - pending
              - processing
              - completed
              - failed
        - name: externalId
          in: query
          description: Filter by the external identifier you provided.
          schema:
            type: string
      responses:
        '200':
          description: A page of withdrawals.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      withdraws:
                        type: array
                        items:
                          $ref: '#/components/schemas/Withdrawal'
                      pageInfo:
                        type: object
                        properties:
                          limit:
                            type: integer
                          offset:
                            type: integer
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: User not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
      servers:
        - url: https://third-party.lootrush.com
components:
  schemas:
    Withdrawal:
      type: object
      properties:
        id:
          type: string
          description: Entry ID.
        bulkId:
          type: string
          format: uuid
          description: Bulk payment ID.
        status:
          type: string
          description: Current status of the withdrawal entry.
        amountToPayToken:
          type: string
          description: Amount to be paid (string for precision).
        outCurrencyIsoCode:
          type: string
          description: Currency code (e.g. USDT).
        toAddress:
          type: string
          description: Recipient wallet address.
        externalId:
          type: string
          description: External identifier, if provided.
          nullable: true
        transactionHash:
          type: string
          description: Blockchain transaction hash once processed.
          nullable: true
        transferTokenStatus:
          type: string
          description: On-chain transfer status.
          nullable: true
        errorMessage:
          type: string
          description: Error message if the withdrawal failed.
          nullable: true
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        error:
          type: string
          description: Message describing what went wrong.
  responses:
    Unauthorized:
      description: Invalid or missing API token, or user not allowed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API token issued by your LootRush account manager. Sent as
        `Authorization: Bearer <token>`.

````