Get Conversion
Get a previously submitted conversion using its ID
Authorizations
Bearer authentication with an API token
Path Parameters
Conversion identifier.
Response
Success
Client-provided request_id (UUID). Idempotency key for internal
reconciliation only; do not surface on end-user receipts — use id.
[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}Amount in source currency.
Account ID debited for the conversion
Purpose of the payment
PAYMENT_PURPOSE_UNSPECIFIED, SALARY_PAYMENT, PERSONAL_REMITTANCE, RENT_PAYMENT, PROPERTY_PURCHASE, OWNED_ACCOUNT_ABROAD, ADVERTISING_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, CONSTRUCTION, DELIVERY_FEES, EDUCATION, EXPORTS, DONATION, HOTEL, LOAN_PAYMENT, MAINTENANCE_EXPENSES, MEDICAL_EXPENSE, OFFICE_EXPENSES, ROYALTY_FEES, SERVICE_CHARGE, SHARES_INVESTMENT, TAX_PAYMENT, TRANSPORTATION_FEES, TRAVEL, UTILITY_BILLS, INTERNAL_BUSINESS_MOVEMENT "SALARY_PAYMENT"
Source configuration
Destination configuration
Server-generated unique conversion ID (KSUID). This is the canonical transaction identifier; use it on end-user receipts and references.
Inferred conversion type
CONVERSION_TYPE_UNSPECIFIED, ON_RAMP, OFF_RAMP "ON_RAMP"
Current external status of the conversion
CONVERSION_STATUS_UNSPECIFIED, INITIATED, PROCESSING, IN_REVIEW, PAYOUT_INITIATED, PAYOUT_COMPLETED, COMPLETED, FAILED, CANCELLED, RETURNED "INITIATED"
(OPTIONAL) Deposit instructions for MemoID On-Ramp.
Timestamps
Timestamp for when conversion reached terminal COMPLETED status.
The exchange rate applied to the conversion.
Rolled-up total of all fees visible to the end user.
Destination currency symbol (e.g., "USD", "MXN", "KRW").
Itemized fee breakdown.
Fee model applied to this conversion. INCLUSIVE means fees are deducted from the source amount so the user sends exactly the quoted amount.
FEE_MODEL_UNSPECIFIED, INCLUSIVE, DEDUCTED, ON_TOP "INCLUSIVE"
Currency that fees_total is expressed in.
CONVERSION_CURRENCY_UNSPECIFIED, USDC, USD, MXN, INR, KRW, USDT, GHS, EUR "USDC"
Quote referenced on submit.
Human-readable reason when the conversion failed, was canceled, or was returned. Omitted when unset.
Present only when status is RETURNED.
Related topics
Conversion notificationsGet QuoteConversions API overviewGet Transaction Limit PolicySubmit Conversion