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

# List Transactions

> Get list of transactions from a specified creation date/time, with optional filters on date range, transaction status (e.g., Pending, Completed, Failed), and currency pairs.



## OpenAPI

````yaml /openapi.json get /api/transactions
openapi: 3.0.1
info:
  title: AxisFi API 接口文档
  description: 认证需同时提供 API Key 和 Secret
  version: v1.0.0
servers:
  - url: http://127.0.0.1:8083
    description: Generated server url
security:
  - X-API-Key: []
    X-API-Secret: []
paths:
  /api/transactions:
    get:
      tags:
        - Transactions
      summary: List Transactions
      description: >-
        Get list of transactions from a specified creation date/time, with
        optional filters on date range, transaction status (e.g., Pending,
        Completed, Failed), and currency pairs.
      operationId: list_1
      parameters:
        - name: page_number
          in: query
          description: Page Number
          required: true
          schema:
            type: integer
            format: int32
        - name: page_size
          in: query
          description: Page Size
          required: true
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: Operation Successful
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PageRespVoTransactionListRespVo'
        '400':
          description: Invalid Parameter
          content:
            application/json:
              example:
                errors:
                  - detail: <string>
                    code: <string>
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                errors:
                  - detail: <string>
                    code: <string>
        '403':
          description: Forbidden (No Permission)
          content:
            application/json:
              example:
                errors:
                  - detail: <string>
                    code: <string>
        '404':
          description: Not Found
          content:
            application/json:
              example:
                errors:
                  - detail: <string>
                    code: <string>
        '405':
          description: Method Not Allowed
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorRespVo'
        '500':
          description: Internal Server Error
          content:
            application/json:
              example:
                errors:
                  - detail: <string>
                    code: <string>
components:
  schemas:
    PageRespVoTransactionListRespVo:
      type: object
      properties:
        page_number:
          type: integer
          format: int32
        page_size:
          type: integer
          format: int32
        total:
          type: integer
          format: int64
        items:
          type: array
          items:
            $ref: '#/components/schemas/TransactionListRespVo'
    ErrorRespVo:
      type: object
      properties:
        errors:
          type: array
          description: 错误信息列表
          items:
            $ref: '#/components/schemas/ErrorDetailRespVo'
      description: 错误响应结果
    TransactionListRespVo:
      type: object
      properties:
        id:
          type: string
          description: Transaction ID
          example: tx_12345678
        reference_id:
          type: string
          description: External Reference ID
          example: ref_98765432
        type:
          type: string
          description: 'Transaction type: deposit, transfer, exchange'
          example: deposit
          enum:
            - deposit
            - transfer
            - exchange
        status:
          type: string
          description: Transaction status
          example: success
        sender_amount:
          type: number
          description: Sender transaction amount
          example: 100
        receiver_amount:
          type: number
          description: Receiver transaction amount
          example: 99.8
        exchange_rate:
          type: number
          description: Exchange rate for transaction
          example: 1.002
        created_at:
          type: string
          description: Transaction created time
          format: date-time
      description: Transaction List Response
    ErrorDetailRespVo:
      type: object
      properties:
        detail:
          type: string
          description: 错误详细描述
          example: Invalid organizationId
        code:
          type: string
          description: 错误码
          example: ORG_ID_INVALID
      description: 错误详情
  securitySchemes:
    X-API-Key:
      type: apiKey
      description: Includes an API key in the HTTP headers to authenticate the client.
      name: X-API-Key
      in: header
    X-API-Secret:
      type: apiKey
      description: Includes an API secret in the HTTP headers to authenticate the client.
      name: X-API-Secret
      in: header

````