Sign in
Conversions

Create conversion

Creates and executes a conversion.

post/v1/conversions

Headers

Idempotency-Keystring required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

source_account_idstring uuid required

ID of the source account to debit.

target_account_idstring uuid required

ID of the target account to credit.

source_amountstring required

Amount to convert as a string decimal (e.g. "100.50").

metadataobject

Key-value pairs stored with the conversion.

Example request

{
  "source_account_id": "550e8400-e29b-41d4-a716-44665544000b",
  "target_account_id": "550e8400-e29b-41d4-a716-44665544000c",
  "source_amount": "100.50",
  "metadata": {
    "invoice_id": "INV-2026-0042"
  }
}

Response

Success

idstring uuid required

Unique identifier of the conversion.

quote_idstring uuid nullable required

ID of the associated quote, or null.

type'conversion' required

Resource type discriminator.

status'pending' | 'completed' | 'failed' required

Current status of the conversion.

source_amountstring required

Source amount as a string decimal.

source_currency'EUR' | 'GBP' | 'USD' | 'USDC' required

Source currency code.

target_currency'EUR' | 'GBP' | 'USD' | 'USDC' required

Target currency code.

source_account_idstring nullable required

ID of the source account, or null.

target_account_idstring nullable required

ID of the target account, or null.

metadataobject required

Key-value pairs stored with the conversion.

created_atstring date-time required

ISO 8601 UTC timestamp when the conversion was created.

updated_atstring date-time required

ISO 8601 UTC timestamp when the conversion was last updated.

completed_atstring date-time nullable required

ISO 8601 UTC timestamp when the conversion completed, or null.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440006",
  "quote_id": "550e8400-e29b-41d4-a716-446655440007",
  "source_amount": "100.50",
  "source_currency": "EUR",
  "target_currency": "USD",
  "source_account_id": "550e8400-e29b-41d4-a716-44665544000b",
  "target_account_id": "550e8400-e29b-41d4-a716-44665544000c",
  "metadata": {
    "invoice_id": "INV-2026-0042"
  },
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:35:00Z",
  "completed_at": "2026-01-15T10:36:00Z"
}

Changes