> ## 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 current rates, fees, and the 3-minute quote validity window.

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.

## Prerequisites

Before you begin, ensure that you have:

* A Busha Business Account and Secret API Key (from the [Quick Start Tutorial](https://docs.busha.io/guides/getting-started/quick-start.md)).

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

* A valid Quote ID from a previously created quote (e.g., `QUO_uNiw1CDqGrdIlK15N0bu1` from the [Creating A Quote Guide](https://docs.busha.io/guides/quotes/create-first-quote.md)).

> [!NOTE]
>
> 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

**1. 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.

**2. 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'
```

**3. 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:**

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

* [Processing Fiat Deposits](https://docs.busha.io/guides/deposits/process-fiat-deposits.md)

* [Processing Crypto Deposits](https://docs.busha.io/guides/deposits/process-crypto-deposits.md)

* [Processing Payouts](https://docs.busha.io/guides/payouts/process-payouts.md)

* [Converting Balance Currencies](https://docs.busha.io/guides/balance/convert-balance-to-balance.md)

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.