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

# Read all autoconversion rules

> This endpoint reads all autoconversion rules, newest first.



## OpenAPI

````yaml /openapi/api-production.yaml get /autoconversion-rules
openapi: 3.1.0
info:
  version: 1.0.0
  title: Lumx API
  description: >-
    A cross-border banking API with instant settlements and unmatched liquidity,
    powered by stablecoins.
servers:
  - url: https://api.lumx.io
  - url: https://api-sandbox.lumx.io
security: []
paths:
  /autoconversion-rules:
    get:
      tags:
        - Autoconversion Rules
      summary: Read all autoconversion rules
      description: This endpoint reads all autoconversion rules, newest first.
      parameters:
        - name: customerId
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Filter rules by customer.
        - name: size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 25
          description: Number of rules to return per page.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: >-
            Cursor for pagination. Use the nextCursor from the previous response
            to get the next page.
      responses:
        '200':
          description: Resources successfully retrieved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    description: An array containing all autoconversion rules.
                    type: array
                    items:
                      $ref: '#/components/schemas/AutoconversionRuleListItem'
                  pagination:
                    type: object
                    description: Pagination metadata for the response.
                    properties:
                      size:
                        type: integer
                        description: Number of items per page.
                        example: 25
                      total:
                        type: integer
                        description: Total number of items available.
                        example: 1
                      hasNextPage:
                        type: boolean
                        description: Whether more items are available after this page.
                        example: false
                      nextCursor:
                        type: string
                        format: uuid
                        nullable: true
                        description: >-
                          Cursor to fetch the next page. `null` when
                          `hasNextPage` is false.
                        example: null
      security:
        - apiKey: []
components:
  schemas:
    AutoconversionRuleListItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Autoconversion rule's unique identifier.
          example: c7f64332-5d53-4685-8aa9-48a5348c18c2
        accountId:
          type: string
          format: uuid
          description: Account that receives the deposits.
          example: 44dd9734-176a-4ced-924f-103f8d50ea5e
        partnerFeeId:
          type: string
          format: uuid
          nullable: true
          description: Partner fee applied to each conversion. `null` when not set.
          example: 123e4567-e89b-12d3-a456-426614174004
        status:
          type: string
          enum:
            - ACTIVE
          description: Autoconversion rule's status.
          example: ACTIVE
        provider:
          type: string
          enum:
            - STARKBANK
            - FINTOC
            - ONE_MONEY
          description: Banking provider that matches the deposits.
          example: STARKBANK
        sourceCurrency:
          type: string
          enum:
            - USD
            - BRL
            - EUR
            - MXN
          description: >-
            Source currency of the conversions, derived from the account's
            currency.
          example: BRL
        targetCurrency:
          type: string
          enum:
            - USDC
            - USDT
          description: Asset deposits are converted into.
          example: USDC
        blockchain:
          type: string
          enum:
            - ETHEREUM
            - BASE
            - TRON
            - POLYGON
          description: Blockchain the converted asset is delivered on.
          example: POLYGON
        purpose:
          type: string
          enum:
            - PERSONAL_ACCOUNT
            - INVESTMENT
            - REAL_ESTATE
            - TRADE_TRANSACTIONS
            - TAX
            - LOAN
            - BILLS
            - EXPENSES_REIMBURSEMENT
            - PROFESSIONAL_SERVICES
          description: End-use category of the funds.
          example: INVESTMENT
        name:
          type: string
          description: A label for the rule, visible only to you.
          example: BRL → USDC investment
        createdAt:
          type: string
          format: date-time
          description: Creation date and time (UTC).
          example: '2026-07-08T23:18:58.574Z'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Bearer authentication header on the format `Bearer <API_KEY>`.

````