---
title: "GET /v1/customers/{customer_id}/auto-conversion-rules/list"
method: GET
path: "/v1/customers/{customer_id}/auto-conversion-rules/list"
tags: ["crate::transaction::instruction::controller::openapi::auto_conversion_rule"]
---

# GET /v1/customers/{customer_id}/auto-conversion-rules/list

`GET /v1/customers/{customer_id}/auto-conversion-rules/list`

## Request

- Base URL: `https://api.1money.com`
- URL: `https://api.1money.com/v1/customers/{customer_id}/auto-conversion-rules/list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/1money/apis/1money-openapi/docs/v1/customers/:customer_id/auto-conversion-rules/list/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `customer_id` string, required

## Query parameters

- `include_subaccounts` boolean
- `pagination` object, required: Pagination query parameters. Two query parameter formats are supported: - Flat format (recommended): `?page=1&size=10` - Nested format: `?pagination=page=1&size=10` Both formats are functionally equivalent. We recommend using the flat format.
  - `page` integer: Page number (starts from 1, default: 1)
  - `size` integer: Number of items per page (1-100, default: 10)

## Response `200`

Successfully retrieved Auto-Conversion Rule list

- OpenApiAutoConversionRuleListResponse: Paginated Auto-Conversion Rule list response
  - `total` integer, required: Total number of Auto-Conversion Rules matching the query
  - `items` OpenApiAutoConversionRuleResponse[], required: List of Auto-Conversion Rules (source_deposit_info not included, use retrieve for full details)
    - `customer_id` string, required: Portfolio ID — also exposed as `customer_id` in OpenAPI. Identifies one individual application / portfolio row within an entity.
    - `account_id` string, nullable: External account identifier of the owning customer
    - `auto_conversion_rule_id` string, required: Unique Auto-Conversion Rule identifier (UUID)
    - `idempotency_key` string, required: HTTP `Idempotency-Key` header value. Stricter than other IDs: ≤64 ASCII chars per the common REST API convention.
    - `nickname` string, required: Auto-generated nickname based on source/destination
    - `status` 'Pending' | 'Active' | 'Inactive' | 'Failed', required: Instruction Status - defines the lifecycle state of an instruction
    - `source` OpenApiSourceAssetInfo, required: Source asset information for Auto-Conversion Rule
      - `asset` string, required: - Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported) - Digital assets: BTC, ETH, SOL - Fiat currencies: USD, MXN
      - `network` string, required: Public network identifier for bank, blockchain and internal transactions. Allowed values: - Bank: `US_ACH`, `US_FEDWIRE`, `US_RTP`, `US_FEDNOW`, `SWIFT`, `CUBIX`, `SPEI`, `PIX_TRANSFER`, `LOCAL_BANK_TRANSFER`, `CHATS`, `FPS`, `SEPA`, `FASTER_PAYMENT`, `UAEFTS`, `UPI`, `EREBOR_RAIL` - Blockchain: `ETHEREUM`, `POLYGON`, `ARBITRUM`, `AVALANCHE`, `BASE`, `BNBCHAIN`, `SOLANA`, `TRON`, `ONE_MONEY`, `BITCOIN` - Internal: `INTERNAL` Availability depends on the asset and customer account configuration.
    - `destination` OpenApiDestinationAssetInfo, required: Destination asset information for Auto-Conversion Rule
      - `asset` string, required: - Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported) - Digital assets: BTC, ETH, SOL - Fiat currencies: USD, MXN
      - `network` string: Public network identifier for bank, blockchain and internal transactions. Allowed values: - Bank: `US_ACH`, `US_FEDWIRE`, `US_RTP`, `US_FEDNOW`, `SWIFT`, `CUBIX`, `SPEI`, `PIX_TRANSFER`, `LOCAL_BANK_TRANSFER`, `CHATS`, `FPS`, `SEPA`, `FASTER_PAYMENT`, `UAEFTS`, `UPI`, `EREBOR_RAIL` - Blockchain: `ETHEREUM`, `POLYGON`, `ARBITRUM`, `AVALANCHE`, `BASE`, `BNBCHAIN`, `SOLANA`, `TRON`, `ONE_MONEY`, `BITCOIN` - Internal: `INTERNAL` Availability depends on the asset and customer account configuration.
      - `wallet_address` string, nullable: Wallet address for automatic crypto withdrawal (fiat->crypto or crypto->crypto). Omit for conversion-only.
      - `external_account_id` string, nullable: External account ID for automatic fiat withdrawal (crypto->fiat only). Omit for conversion-only.
      - `code` string, nullable: Canonical local payment code for a crypto-to-fiat bank payout. Select the applicable value from the [Local Payment Code](https://developer.1money.com/docs/local-payment-code) guide and submit it exactly as documented.
      - `memo` string, nullable: Memo delivered to the beneficiary bank on every payout this rule produces. Applied only for a fiat destination with `external_account_id`; otherwise ignored (same discard pattern as withdrawal `memorandum`). Normalized on create: characters outside `A-Z a-z 0-9` and `/?:().,'+-` are stripped, then the result is capped at the destination rail's limit (80 for ACH, 140 for WIRE and SWIFT). The stored value is what the bank receives, and it is what this field returns.
    - `deposit_info_status` string: Status of source deposit info: PENDING (not yet active), ACTIVE (available), INACTIVE (temporarily unavailable)
    - `source_deposit_info` union: Source deposit info (bank for fiat, wallet for crypto)
      - OpenApiBankDepositInfo: Bank deposit instructions for a fiat source.
        - `network` string, required: Bank network. FedNow uses `US_FEDNOW`; ACH and wire retain `ach` and `wire`.
        - `reference_code` string, required: Auto-conversion rule reference code to include in the bank transfer memo.
        - `recipient_name` string: Optional recipient display name from the bank instruction provider. For fiat deposits, use `account_holder_name` as the beneficiary/account name when entering bank transfer details. This field is retained for backward compatibility and may be absent or duplicate `account_holder_name`.
        - `bank_name` string: Receiving bank name
        - `routing_number` string: Bank routing number (for US domestic transfers)
        - `account_holder_name` string: Beneficiary/account holder name to use when sending a fiat bank transfer. Prefer this field over `recipient_name` when both fields are present.
        - `account_number` string: Bank account number
        - `country_code` string: Country code (ISO 3166-1 alpha-3)
        - `street` string: Bank street address
        - `additional` string, nullable: Additional address information
        - `city` string: City
        - `region` string: State/Region
        - `postal_code` string: Postal/ZIP code
        - `bic_code` string: BIC/SWIFT code for international wire transfers
        - `minimum_deposit_amount` string, required: Minimum deposit amount required
      - OpenApiCryptoDepositInfo: Crypto wallet deposit info for crypto source (USDC/USDT)
        - `wallet_address` string, required: Wallet address for receiving crypto deposits. Send tokens to this address.
        - `minimum_deposit_amount` string, required: Minimum deposit amount required
        - `contract_address` string, required: Token contract address (ERC-20). Empty string for native tokens.
    - `created_at` string, required: Auto-Conversion Rule creation timestamp (ISO 8601)
    - `modified_at` string, required: Last modification timestamp (ISO 8601)

## Other responses

- `400`: Invalid request parameters
- `401`: Authentication failed
- `405`: Method not allowed
- `500`: Internal server error

## Changes

- **2026-11-03** `d213edbaccb6`: 1 breaking, 4 info
  - the `total` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - api tag `crate::transaction::instruction::controller::openapi::auto_conversion_rule` added
  - api tag `Auto-Conversion Rules` removed
  - added the optional property `items/items/destination/code` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/1money/apis/1money-openapi/changes/v1/customers/:customer_id/auto-conversion-rules/list/get.md)

---

[API](https://skmtc.dev/1money/apis/1money-openapi.md) - [All operations](https://skmtc.dev/1money/apis/1money-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/1money/apis/1money-openapi/revisions/d213edbaccb6?raw)