Documentation Index

Fetch the complete documentation index at: https://docs.xendit.co/llms.txt

Use this file to discover all available pages before exploring further.

For archived content, access the previous documentation here or the previous API reference here.

Get Quote by ID

  • Published on May 26, 2026
Prev Next
Get
/quotes/{quote_id}

Retrieve a specific Quote using its ID

Security
HTTP
Type Basic

Secret API Key authentication. Required permission: MONEY-OUT

Header parameters
api-version
stringRequired

The version of the API. Value: "2025-06-06"

Path parameters
quote_id
stringRequired
Responses
200

The request has succeeded.

Get Quote PHP to THB

Get Quote PHP to THB

{
  "quote_id": "qo-7c4d2e1f-a8b9-4f3e-9d6c-5a1b2c3d4e5f",
  "reference_id": "a3f7c912-4e8b-4d1a-bc56-9f2e1a3d7b4c",
  "source_amount": 78500,
  "source_currency": "PHP",
  "destination_amount": 500000,
  "destination_currency": "THB",
  "fx_rate": 0.637,
  "type": "PAYOUT",
  "created": "2025-06-03T09:15:00Z",
  "updated": "2025-06-03T09:15:00Z",
  "expires": "2025-06-03T09:15:30Z"
}
Get Quote by ID

Get Quote by ID

{
  "quote_id": "qo-e08492aa-d872-4c49-9fcf-c271480dbdc0",
  "reference_id": "179d2fbc-e0c2-467d-8acd-b0b7cc4ee3f8",
  "source_amount": 100000,
  "source_currency": "IDR",
  "destination_amount": 626,
  "destination_currency": "USD",
  "fx_rate": 6.3E-05,
  "type": "PAYOUT",
  "created": "2025-06-02T16:01:15.982Z",
  "updated": "2025-06-02T16:01:15.982Z",
  "expires": "2025-06-02T16:01:45.967Z"
}
object

Quote Object

quote_id
string

Unique Quote ID in UUID format, prefixed with qo-

reference_id
string

ID provided by merchant to identify the request

source_currency
string

Source currency

Valid values[ "USD", "SGD", "IDR", "PHP", "MYR", "THB", "VND", "HKD", "CNY", "KRW", "AUD", "EUR", "MXN" ]
source_amount
integer

Source amount in minor units.

A minor unit is the smallest unit of a currency. Most currencies have 2 decimals, others have 0. Examples: PHP 10.00 → 1000, IDR 10 → 10.

destination_currency
string

Destination currency

Valid values[ "USD", "SGD", "IDR", "PHP", "MYR", "THB", "VND", "HKD", "CNY", "KRW", "AUD", "EUR", "MXN" ]
destination_amount
integer

Destination amount in minor units.

A minor unit is the smallest unit of a currency. Most currencies have 2 decimals, others have 0. Examples: PHP 10.00 → 1000, IDR 10 → 10.

fx_rate
number (double)

Exchange rate

type
string

Type of transaction which the Quote will be used for

Valid values[ "CONVERSION", "PAYOUT" ]
created
string (date-time)

Timestamp when the quote was made. Format: ISO 8601, UTC+0

updated
string (date-time)

Timestamp when the quote was last updated. Format: ISO 8601, UTC+0

expires
string (date-time)

Timestamp when the quote will expire. Format: ISO 8601, UTC+0

401

Unauthorized

object
error_code
string
Valid values[ "INVALID_API_KEY" ]
message
string
Valid values[ "API key format is invalid" ]
403

Forbidden

object
error_code
string
Valid values[ "REQUEST_FORBIDDEN_ERROR" ]
message
string
Valid values[ "The API key is forbidden to perform this request" ]
404

Not found

object
error_code
string
Valid values[ "DATA_NOT_FOUND" ]
message
string
Valid values[ "Quote not found" ]
500

Internal server error

object
error_code
string
Valid values[ "SERVER_ERROR" ]
message
string
Valid values[ "An unexpected error occurred" ]