Get Quote by ID
GET/v1/crossborder/quotes/:id
Retrieve detailed information about a specific crossborder quote by providing the quote ID.
Request
Path Parameters
Quote ID.
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
Responses
- 200
- 400
- 401
Quote returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Quote ID.
Rate ID.
client objectrequired
Client ID.
Client name.
Client email.
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Client type.
Client country.
Client phone number.
Client document.
client_account object
Possible values: [CHECKING, SAVINGS]
Client account type.
Client account number.
Client branch.
Client bank name.
Client bank code.
counterparty objectrequired
Counterparty ID.
Counterparty name.
Counterparty email.
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Counterparty type.
Counterparty country.
Client phone number.
Client document.
counterparty_account object
Possible values: [CHECKING, SAVINGS]
Counterparty account type.
Counterparty account number.
Counterparty branch.
Counterparty bank name.
Counterparty bank code.
deposit_info objectrequired
Bank name for deposit.
Bank code.
Bank account branch.
Beneficiary account number.
Beneficiary name.
Beneficiary document.
Possible values: [PENDING, CREATED, APPROVED, REJECTED, PAID, CANCELED, FAILED, SETTLED]
Quote status.
Base currency symbol.
Quote currency symbol.
Base amount in cents.
Quote amount in cents.
Possible values: [buy, sell]
Quote side (buy or sell).
Foreign exchange rate.
Spread in basis points (bps).
Tax amount in cents.
VET (tax/fee) in cents.
Description.
Liquidity provider.
Possible values: [D0, D1, D2, D3]
Settlement type.
Settlement date.
Paid date.
Approval date.
Rejection date.
Cancellation date.
Failure date.
Reversal date.
Quote created date.
Quote updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"rate_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"client": {
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"name": "John Doe",
"email": "john.doe@example.com",
"type": "NATURAL_PERSON",
"country": "US",
"phone_number": "+5511999999999",
"document": "12345678901"
},
"client_account": {
"account_type": "CHECKING",
"account_number": "12345-6",
"branch": "0001",
"bank_name": "Bank of America",
"bank_code": "001"
},
"counterparty": {
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"name": "John Doe",
"email": "john.doe@example.com",
"type": "NATURAL_PERSON",
"country": "US",
"phone_number": "+5511999999999",
"document": "12345678901"
},
"counterparty_account": {
"account_type": "CHECKING",
"account_number": "12345-6",
"branch": "0001",
"bank_name": "Bank of America",
"bank_code": "001"
},
"deposit_info": {
"bank_name": "Banco do Brasil",
"bank_code": "001",
"branch": "0001",
"beneficiary_account": "12345-6",
"beneficiary_name": "John Doe",
"beneficiary_document": "123.456.789-00"
},
"status": "PENDING",
"base_currency": "USD",
"quote_currency": "BRL",
"base_amount": 10000,
"quote_amount": 50000,
"side": "buy",
"fx_rate": 50000,
"spread": 100,
"tax": 50,
"vet": 100,
"description": "Payment for services",
"liquidity": "Zro Liquidity Provider",
"settlement_type": "D1",
"settlement_at": "2026-03-06T21:03:37.367Z",
"paid_at": "2026-03-06T21:03:37.367Z",
"approval_at": "2026-03-06T21:03:37.367Z",
"rejection_at": "2026-03-06T21:03:37.367Z",
"cancellation_at": "2026-03-06T21:03:37.367Z",
"failure_at": "2026-03-06T21:03:37.367Z",
"reversal_at": "2026-03-06T21:03:37.367Z",
"created_at": "2026-03-06T21:03:37.367Z",
"updated_at": "2026-03-06T21:03:37.367Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.