---
title: "Get Auto-Conversion Rule by Idempotency Key"
method: GET
path: "/v1/customers/{customer_id}/auto-conversion-rules"
tags: ["Auto-Conversion Rules"]
---

# Get Auto-Conversion Rule by Idempotency Key

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

Look up an Auto-Conversion Rule using the idempotency key provided during creation.

**Use Case:** Verify if an Auto-Conversion Rule was successfully created when network issues or timeouts occurred during the create request.

**Status & Deposit Info:**
- `PENDING`: Deposit info is being prepared. `source_deposit_info` will be `null`.
- `ACTIVE`: Deposit info is ready. `source_deposit_info` contains bank Wire/SWIFT details for fiat source, or wallet address for crypto source.

## Path parameters

- `customer_id` string, required

## Query parameters

- `idempotency_key` string, required — HTTP `Idempotency-Key` header value. Stricter than other IDs: ≤64 ASCII chars per the common REST API convention.

## Response `200`

Successfully retrieved Auto-Conversion Rule

- OpenApiAutoConversionRuleResponse — Auto-Conversion Rule response object
  - `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 - Fiat currencies: USD
    - `network` string, required
  - `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 - Fiat currencies: USD
    - `network` string
    - `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.
  - `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 info for fiat source (USD via Wire/SWIFT)
      - `network` string, required — Network type: wire or swift
      - `reference_code` string, required — Reference code (memo) - IMPORTANT: Must include this in your wire transfer for proper routing
      - `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` — Missing or empty idempotency_key query parameter
- `401` — Authentication failed
- `404` — No Auto-Conversion Rule found with this idempotency key
- `405` — Method not allowed
- `500` — Internal server error

---

[API](https://skmtc.net/1money/apis/1money-openapi.md) · [All operations](https://skmtc.net/1money/apis/1money-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/1money/1money-openapi/versions/aa2718d28cb5/schema)