Retrieve a Quote

After successfully creating a Quote, a unique id is returned in the API response. This Quote ID is essential for initializing and finalizing subsequent transfers. This guide will show you how to use this ID to retrieve the full details of any existing quote.

What You’ll Achieve:

Understand why and when to retrieve quote information.
Successfully make an API request to fetch a specific quote.
Interpret the comprehensive Quote response, including pay_in and pay_out details.

Prerequisites

Before you begin, ensure that you have:

A Busha Business Account and Secret API Key (from the Quick Start Tutorial).
An understanding of API Environments (Sandbox vs. Production) and their base URLs (from the Make Your First Request Guide).
A valid Quote ID from a previously created quote (e.g., QUO_uNiw1CDqGrdIlK15N0bu1 from the Creating A Quote Guide).

For quote requests involving a customer, the X-BU-PROFILE-ID field should be included in the request header, and its value should be set to the customer ID for whom the request is performed on their behalf.

How to Retrieve a Quote

Understand the Get Quote API Endpoint

To retrieve quote information, you’ll use the GET method on the /v1/quotes/{id} endpoint. This endpoint allows you to query the state and details of a specific quote by providing its unique ID.Why retrieve a Quote?

Check Quote Validity: Quotes are valid for 3 minutes from creation. After that, they expire and transfers can no longer be created from them. Create the transfer before the quote expires. The quoted rate is honoured for the remainder of the same 3-minute quote validity window; creating a transfer does not restart it.
Confirm Details: Double-check source_amount, target_amount, rate, and fees.
Retrieve Transfer Instructions: If the quote includes pay_in or pay_out details (e.g., a deposit address or bank details), you can retrieve them here to present to your users.
Monitor Status: Check the quote status and expires_at before creating a transfer. A successful transfer creation does not extend the quote validity window.

Make the Request to Get Quote Information

Use the GET request below, replacing the placeholders with your actual values.To retrieve quote information:

Open your terminal or command prompt
Construct a GET request to the /v1/quotes/{id} endpoint.
Replace YOUR_BASE_URL with your chosen environment’s URL (e.g., https://api.sandbox.busha.so).
Replace {id} with the actual ID of the quote you wish to retrieve (e.g., QUO_uNiw1CDqGrdIlK15N0bu1).

Replace {YOUR_SECRET_API_KEY} with your actual Secret API Key.

$ curl --request GET \
  --url YOUR_BASE_URL/v1/quotes/{id} \
  --header 'Authorization: Bearer {YOUR_SECRET_API_KEY}' \
  --header 'Content-Type: application/json'

Example:

$ curl -i -X GET https://api.sandbox.busha.so/v1/quotes/QUO_AEv8vGiT4jvB \
  -H 'Authorization: Bearer {YOUR_SECRET_API_KEY}' \
  -H 'Content-Type: application/json'

Interpret the Quote Response

Upon a successful request, the API will return the full Quote object, including its rate, calculated amounts, and expires_at. Check that the quote is still within its 3-minute validity window before creating a transfer.Expected Response:

{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_AEv8vGiT4jvB",
    "profile_id": "",
    "source_currency": "NGN",
    "target_currency": "BTC",
    "source_amount": "200000",
    "target_amount": "0.00118096",
    "rate": {
      "product": "BTCNGN",
      "rate": "169353287.78",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "BTC"
    },
    "fees": [],
    "reference": "QUO_AEv8vGiT4jvB",
    "status": "pending",
    "expires_at": "2025-06-10T08:10:26.721165473Z",
    "created_at": "2025-06-10T08:07:26.721165473Z",
    "updated_at": "2025-06-10T08:07:56.721165473Z"
  }
}

Troubleshooting Common Issues:

404 Not Found: The provided {id} does not correspond to an existing quote. Double-check the ID.
401 Unauthorized: Ensure your Authorization: Bearer {YOUR_SECRET_API_KEY} header is correct and includes a valid API key.
Quote expired or deposit received late: Quotes are valid for 3 minutes from creation. After that, they expire and transfers can no longer be created from them. Create the transfer before the quote expires. The quoted rate is honoured for the remainder of the same 3-minute quote validity window; creating a transfer does not restart it. For transfers involving deposits, ensure the deposit is received within the same quote validity window. Deposits received outside that window are settled at the market rate. Check expires_at before creating the transfer. If the quote has expired, request a new one.

What’s Next?

Now that you know how to retrieve quote information, you can use this ID to proceed with your desired transaction:

Start Here

Accept Payments (API)

Accept Payments (SDK & Widgets)

On/Off Ramp (API)

Customer Onboarding (B2B2C)

Balance & Treasury

Recipients

Token Sharing

Request ID

OAuth2

Pledges

Webhooks

Reference

Prerequisites

How to Retrieve a Quote

Troubleshooting Common Issues:

What’s Next?

​Prerequisites

​How to Retrieve a Quote

​Troubleshooting Common Issues:

​What’s Next?

Prerequisites

How to Retrieve a Quote

Troubleshooting Common Issues:

What’s Next?