Get Conversion by ID

GET 
/otc/conversions/:id

Retrieve detailed information about a currency conversion by specifying its ID.

Request

Path Parameters

id stringrequired

Conversion UUID.

Header Parameters

nonce stringrequired

The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

x-lang string

Possible values: [pt-BR, en-US]

Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

x-product-uuid string

The product ID is a UUID (v4) used to identify the Z.ro product configuration.

x-product-target-user-uuid string

The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

Responses

200

Conversion returned successfully.

application/json

Schema

Schema

id stringrequired

Conversion UUID.

operation_id stringrequired

Operation UUID. Used to track the conversion.

quotation_id string

Quotation UUID. Used to track the quotation for this conversion.

price numberrequired

Conversion price.

side stringrequired

Possible values: [buy, sell]

Conversion side.

quote_amount numberrequired

Conversion quote amount.

quote_currency_symbol stringrequired

Conversion quote currency symbol.

quote_currency_decimal numberrequired

Conversion quote currency decimal.

quote_currency_title stringrequired

Conversion quote currency title.

base_amount numberrequired

Conversion base amount.

base_currency_symbol stringrequired

Conversion base currency symbol.

base_currency_decimal numberrequired

Conversion base currency decimal.

base_currency_title stringrequired

Conversion base currency title.

created_at date-time

Conversion created at.

Example (from schema)

{
  "id": "f6e2e084-29b9-4935-a059-5473b13033aa",
  "operation_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
  "quotation_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
  "price": 0,
  "side": "buy",
  "quote_amount": 0,
  "quote_currency_symbol": "BRL",
  "quote_currency_decimal": "2",
  "quote_currency_title": "Real",
  "base_amount": 0,
  "base_currency_symbol": "BTC",
  "base_currency_decimal": "8",
  "base_currency_title": "Real",
  "created_at": "2025-06-03T14:44:50.674Z"
}

400

If any required params are missing or has invalid format or type.

Authorization: http

name: bearertype: httpscheme: bearerbearerFormat: JWT

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET 'https://docs.zrobank.io/otc/conversions/:id' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Auth

Bearer Token

Parameters

id — pathrequired

nonce — headerrequired

x-lang — header

---pt-BRen-US

x-product-uuid — header

x-product-target-user-uuid — header

ResponseClear

Click the Send API Request button above and see the response here!