Conversions

Retrieve conversion

Retrieves a conversion by ID.

get/v1/conversions/{id}

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440006

Unique identifier of the conversion.

Response

The conversion resource

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