GuideReference

Get 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:

  1. Understand why and when to retrieve quote information.

  2. Successfully make an API request to fetch a specific quote.

  3. Interpret the comprehensive Quote response, including pay_in and pay_out details.

PrerequisitesCopied!

Before you begin, ensure that you have:

Step 1: Understand the Get Quote API EndpointCopied!

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 Expiration: Verify if the quote is still valid before attempting to use it for a transaction.

  • 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: Although quotes typically stay pending until used or expired, checking its status can confirm its existence.

Step 2: Make the Request to Get Quote InformationCopied!

Use the GET request below, replacing the placeholders with your actual values.

To retrieve quote information:

  1. Open your terminal or command prompt

  2. Construct a GET request to the /v1/quotes/{id} endpoint.

  3. Replace YOUR_BASE_URL with your chosen environment’s URL (e.g., https://api.sandbox.busha.so ).

  4. Replace {id} with the actual ID of the quote you wish to retrieve (e.g., QUO_uNiw1CDqGrdIlK15N0bu1).

  5. 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'

Step 3: Interpret the Quote ResponseCopied!

Upon a successful request, the API will return the full Quote object, which is identical to the response you received when the quote was created.

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:37:56.721186819Z",
    "created_at": "2025-06-10T08:07:26.721165473Z",
    "updated_at": "2025-06-10T08:07:56.721165473Z"
  }
}

Troubleshooting Common Issues:Copied!

  • 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.

  • Expired Quote: If expires_at is in the past, the quote cannot be used. You will need to create a new quote.

What’s Next?Copied!

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