Sign in
Conversions

Create conversion

Starts 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 as a string decimal (e.g. "100.50").

metadataobject nullable required

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.

type'conversion' required

Resource type discriminator.

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

Current status of the conversion.

source_amountstring required

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

target_amountstring required

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

source_account_idstring uuid nullable required

ID of the source account, or null.

target_account_idstring uuid 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",
  "source_amount": "100.50",
  "target_amount": "100.50",
  "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