> ## 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 an autoconversion rule

> This endpoint reads an autoconversion rule, including its deposit details.



## OpenAPI

````yaml /openapi/api-production.yaml get /autoconversion-rules/{id}
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/{id}:
    get:
      tags:
        - Autoconversion Rules
      summary: Read an autoconversion rule
      description: >-
        This endpoint reads an autoconversion rule, including its deposit
        details.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Autoconversion rule's unique identifier.
      responses:
        '200':
          description: Resource successfully retrieved.
          content:
            application/json:
              examples:
                PIX:
                  value:
                    id: c7f64332-5d53-4685-8aa9-48a5348c18c2
                    accountId: 44dd9734-176a-4ced-924f-103f8d50ea5e
                    partnerFeeId: 123e4567-e89b-12d3-a456-426614174004
                    status: ACTIVE
                    provider: STARKBANK
                    sourceCurrency: BRL
                    targetCurrency: USDC
                    blockchain: POLYGON
                    purpose: INVESTMENT
                    sourceDepositInfo:
                      - rail: PIX
                        brCode: 00020126...5204
                        depositIdentifier: IIDCDYjYUTbKouEUOyvxZ3xnU
                    createdAt: '2026-07-08T23:18:58.574Z'
                SPEI:
                  value:
                    id: 9b2f11a6-7c3e-4f28-b1d4-2e6a90c5d7f1
                    accountId: 16cb802f-8521-41ad-ab6e-dc40f43c0ad3
                    partnerFeeId: 123e4567-e89b-12d3-a456-426614174004
                    status: ACTIVE
                    provider: ONE_MONEY
                    sourceCurrency: MXN
                    targetCurrency: USDT
                    blockchain: TRON
                    purpose: INVESTMENT
                    sourceDepositInfo:
                      - rail: SPEI
                        clabe: '646180157000000004'
                        reference: IIDCDYjYUTbKouEUOyvxZ3xnU
                    createdAt: '2026-07-08T23:18:58.574Z'
              schema:
                $ref: '#/components/schemas/AutoconversionRuleDetailResponse'
      security:
        - apiKey: []
components:
  schemas:
    AutoconversionRuleDetailResponse:
      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
        sourceDepositInfo:
          type: array
          description: Deposit details to share with the sender, per rail.
          items:
            $ref: '#/components/schemas/AutoconversionRuleDepositInfo'
        createdAt:
          type: string
          format: date-time
          description: Creation date and time (UTC).
          example: '2026-07-08T23:18:58.574Z'
    AutoconversionRuleDepositInfo:
      type: object
      properties:
        rail:
          type: string
          enum:
            - PIX
            - SPEI
          description: Payment rail the deposit details belong to.
          example: PIX
        brCode:
          type: string
          description: PIX copy-paste code. Only present for the PIX rail.
          example: 00020126...5204
        clabe:
          type: string
          description: CLABE to deposit into. Only present for the SPEI rail.
          example: '646180157000000004'
        depositIdentifier:
          type: string
          description: >-
            Reference that ties a deposit to the rule. Only present for the PIX
            rail.
          example: IIDCDYjYUTbKouEUOyvxZ3xnU
        reference:
          type: string
          description: >-
            Reference that ties a deposit to the rule. Only present for the SPEI
            rail.
          example: IIDCDYjYUTbKouEUOyvxZ3xnU
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Bearer authentication header on the format `Bearer <API_KEY>`.

````