> ## Documentation Index
> Fetch the complete documentation index at: https://docs.busha.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a Quote

> Learn how to fetch and verify quote details. Check rates, fees, and expiration times.

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.

<Tip>
  **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.
</Tip>

## Prerequisites

Before you begin, ensure that you have:

* A Busha Business Account and Secret API Key (from the [Quick Start Tutorial](../getting-started/quick-start)).

* An understanding of API Environments (Sandbox vs. Production) and their base URLs (from the [Make Your First Request Guide](../getting-started/make-first-request)).

* A valid Quote ID from a previously created quote (e.g., `QUO_uNiw1CDqGrdIlK15N0bu1` from the [Creating A Quote Guide](./create-first-quote)).

<Info>
  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.
</Info>

## How to Retrieve a Quote

<Steps>
  <Step title="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 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>

  <Step title="Make the Request to Get Quote Information">
    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`).

    Replace `{YOUR_SECRET_API_KEY}` with your actual Secret API Key.

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

    Example:

    ```bash theme={null}
    $ 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>

  <Step title="Interpret the Quote Response">
    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:**

    ```json theme={null}
    {
      "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"
      }
    }
    ```
  </Step>
</Steps>

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

* **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?

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

* [Processing Fiat Deposits](../deposits/process-fiat-deposits)

* [Processing Crypto Deposits](../deposits/process-crypto-deposits)

* [Processing Payouts](../payouts/process-payouts)

* [Converting Balance Currencies](/guides/balance/convert-balance-to-balance)

* [API Reference: Get Quote by ID: For full details on the response fields](../../api-reference/quotes/get-quote).