> ## 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 transaction list



## OpenAPI

````yaml /openapi.json get /transactions
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:
  /transactions:
    get:
      tags:
        - Transactions
      summary: Get transaction list
      operationId: getTransactions
      parameters:
        - in: query
          name: created_from
          schema:
            type: string
            format: date-time
          description: >-
            Start date filter in ISO 8601 format. Example:
            2025-05-01T00:00:19.662Z.
        - in: query
          name: created_to
          schema:
            type: string
            format: date-time
          description: >-
            End date filter in ISO 8601 format. Example:
            2025-05-01T00:00:19.662Z.
        - in: query
          name: currency
          schema:
            type: string
            example: USDT
          description: Currency/token filter. Use one of the supported currency codes.
        - in: query
          name: direction
          schema:
            type: string
            enum:
              - in
              - out
          description: Transaction direction filter.
        - in: query
          name: transaction_id
          schema:
            type: string
          description: Transaction ID filter.
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 300
            default: 100
          description: Pagination limit. Maximum value is 300. Default value is 100.
        - in: query
          name: network
          schema:
            type: string
            example: trx
          description: Network filter. Use one of the supported network codes.
        - in: query
          name: offset
          schema:
            type: integer
            minimum: 0
            default: 0
          description: Pagination offset. Must be greater than or equal to 0.
        - in: query
          name: sort_by
          schema:
            type: string
            enum:
              - status
              - created_at
          description: Sort field.
        - in: query
          name: sort_direction
          schema:
            type: string
            enum:
              - asc
              - desc
          description: Sort direction.
        - in: query
          name: status
          schema:
            type: string
            enum:
              - in_progress
              - completed
              - error
          description: Transaction status filter.
        - in: query
          name: search
          schema:
            type: string
          description: Search by transaction_id, sender_wallet, recipient_wallet or hash.
      responses:
        '200':
          description: OK - transaction 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:
                    $ref: '#/components/schemas/GetTransactionsResponse'
              examples:
                success:
                  summary: Transaction list
                  value:
                    code: '200'
                    error_code: null
                    error_message: null
                    data:
                      count: 321
                      transactions:
                        - transaction_id: '5891781524940'
                          network: trx
                          direction: out
                          status: completed
                          amount: '1'
                          currency: TRX
                          sender_wallet: Exchange TRC20
                          recipient_wallet: TLEdfDn7oyL3h5NYQVgK69E6Y7NKRr23ea
                          hash: >-
                            96fa587a6b44bcb1c2d17958b18d1b2bb89a5453d6be0098f8e1ea8dfe5b591b
                          fee: '0.1'
                          created_at: '2026-06-15 12:02:37.869609+00'
                      result: success
        '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 8601 date-time
                      created_to: Must be valid ISO 8601 date-time
                      limit: Maximum value is 300. Default value is 100
                      offset: Must be greater than or equal to 0
                      direction: 'Allowed values: in, out'
                      status: 'Allowed values: in_progress, completed, error'
                      sort_by: 'Allowed values: status, created_at'
                      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:
    GetTransactionsResponse:
      type: object
      required:
        - count
        - transactions
        - result
      properties:
        count:
          type: integer
          description: Total number of transactions matching the filters.
          example: 321
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/TransactionListItem'
        result:
          type: string
          example: success
    TransactionListItem:
      type: object
      required:
        - transaction_id
        - network
        - direction
        - status
        - amount
        - currency
        - sender_wallet
        - recipient_wallet
        - hash
        - fee
        - created_at
      properties:
        transaction_id:
          type: string
          description: Transaction ID.
          example: '5891781524940'
        network:
          type: string
          description: Blockchain network code.
          example: trx
        direction:
          type: string
          description: Transaction direction.
          enum:
            - in
            - out
          example: out
        status:
          type: string
          description: Transaction status.
          enum:
            - in_progress
            - completed
            - error
          example: completed
        amount:
          type: string
          description: Transaction amount.
          example: '1'
        currency:
          type: string
          description: Currency/token code.
          example: TRX
        sender_wallet:
          type: string
          description: Sender wallet name or address.
          example: Exchange TRC20
        recipient_wallet:
          type: string
          description: Recipient wallet address.
          example: TLEdfDn7oyL3h5NYQVgK69E6Y7NKRr23ea
        hash:
          type: string
          description: Blockchain transaction hash.
          example: 96fa587a6b44bcb1c2d17958b18d1b2bb89a5453d6be0098f8e1ea8dfe5b591b
        fee:
          type: string
          description: Transaction fee.
          example: '0.1'
        created_at:
          type: string
          description: Transaction creation timestamp.
          example: '2026-06-15 12:02:37.869609+00'
  securitySchemes:
    apiKeyAuth:
      in: header
      name: token
      type: apiKey
      description: Pass your API token in the `token` request header.

````