---
title: "Get a Specific Quote"
method: GET
path: "/api/v2/quote/{quote_id}"
tags: ["Quote Management"]
---

# Get a Specific Quote

`GET /api/v2/quote/{quote_id}`

Retrieves the details of a single existing quote by its DealHub Quote ID.

This endpoint allows you to fetch specific data points for any quote in DealHub. The level of detail in the response is controlled by the **`feature`** query parameter.

-   **Minimal Response**: If you don't specify any `feature` parameters, the API returns a basic response containing only the `dealhub_quote_id`, its current `status`, and the `quote_upgrade_required` flag.
-   **Detailed Response**: To get more information, you must include one or more `feature` query parameters in your request.

If a Draft quote was created using an older one, now-inactive version, the `quote_upgrade_required` flag will be `true`. When this occurs, the API will not return any requested `feature` data for that quote.

> 📘 Date Formats
>
> All date values in the response are returned in `yyyy-mm-dd hh:mm:ss` format.

## Path parameters

- `quote_id` string, required

## Query parameters

- `feature` string[]
- `external_identifier_flag` boolean

## Response `200`

Success. Returns the detailed quote object.

- Quote
  - `dealhub_quote_id` string
  - `status` string
  - `quote_upgrade_required` boolean
  - `info` QuoteInfo
    - `external_opportunity_id` string — External opportunity ID (CRM opportunity ID as provided during create quote call).
    - `external_quote_id` string — External quote ID (as provided during create quote call).
    - `external_customer_id` string — External customer ID (CRM customer account ID).
    - `customer_id` string — CPQ customer account ID.
    - `account_name` string — Account name (as provided during quote creation).
    - `contact_name` string — Primary customer contact full name.
    - `contact_email` string, email — Primary customer contact email.
    - `dealhub_opportunity_id` string — DealHub opportunity ID.
    - `dealhub_quote_name` string — DealHub quote name.
    - `dealhub_quote_number` string — Quote ID that is unique per account and presented to user in CPQ UI.
    - `duplicate_from_quote` string — Represents the quote ID (also referred as **Quote Num** in the CPQ UI) from which the current quote was created using the duplication process. If the current quote was duplicated or cloned from another quote, this field will contain the original quote's ID. If the quote was not created through duplication, this field will be empty.
    - `primary_quote` boolean — Primary quote flag.
    - `created_by` string, email — Login of the user who created the quote.
    - `creation_date` string, date-time — GMT date&time of quote creation.
    - `submitted_by` string, email — Login of the user who submitted the quote (if specific quote is submitted).
    - `submission_date` string, date-time — GMT date&time of quote submission (if specific quote is submitted).
    - `expiration_date` string, date-time — Quote expiration date.
    - `won_date` string, date-time — The date the quote was signed.
    - `geo_code` string — Geographic code.
    - `currency` string — Quote currency.
    - `playbook` string — Playbook name.
    - `quote_url` string, uri — Quote URL.
    - `version_id` string — ID of the version in which the quote is managed.
  - `summary` QuoteSummary
    - `currency` string — Quote currency (ISO-4217 format).
    - `total_list_price` number, float — The total list price of the quote.
    - `total_net_price` number, float — Total net price of the quote.
    - `total_discount` number, float — Total discount of the quote.
    - `sales_discount` number, float — Total discount provided by seller.
  - `deal_room_info` DealRoomInfo
    - `url` string, uri — DealRoom URL.
  - `line_items` LineItem[]
    - `sku` string, required — Unique product catalog identifier. It must exist in the DealHub product catalog.
    - `item_name` string — Catalog product name.
    - `bundle_ref_sku` string — The SKU of the bundle product to which this line item belongs. The value is required if the line item is a component of a bundle. The bundle SKU must exist in the DealHub catalog. This field should be empty for the bundle product itself.
    - `bundle_ref_id` integer — The unique identifier for a bundle instance. This is required for all line items within a bundle and for the bundle's line item itself. It is used to differentiate between multiple instances of the same bundle in a single import.
    - `list_price` number — List price of the line item.
    - `net_price_per_unit` number — Net price per unit of the line item.
    - `net_price` number — Total net price (net per unit x product factors).
    - `msrp` number — line item MSRP (Manufacturer Suggested Retail Price).
    - `msrp_discount` number — Discount applied to the MSRP.
    - `sales_discount` number — Line item sales discount.
    - `total_discount` number — Line item total discount.
    - `partner_program_data` object[]
      - `partner_program_name` string — Partner program name.
      - `partner_level_item_price` number — Item price after partner program level discount.
      - `partner_level_item_discount` number — Discount applied to the partner program level.
    - `product_factors` object — List of product-specific factors (e.g., quantity, duration).
    - `attributes` object — List of line-item-specific proposal attributes.
  - `answers` PlaybookAnswer[]
    - `system_name` string — Name of the system, relevant for multi-system concept.
    - `system_id` string — System ID, relevant for multi-system concept.
    - `group_id` string — Group ID.
    - `group_name` string — Group name.
    - `question_id` string — Question ID.
    - `question` string — Question text.
    - `answer` string — The answer.
  - `approvals` Approval[]
    - `reviewer` string, email — Login of the reviewer.
    - `step` integer — Approval workflow step.
    - `reason` string — List of approval reasons.
    - `status` 'waiting' | 'rejected' | 'approved' — Status of the specific step within approval flow.
    - `impersonated_by` string, email — Login of the person who approved/rejected quote on behalf of approver.
    - `review_date` string, date-time — Date of approval/rejection.
    - `reviewer_comment` string — Note added by reviewer.

## Other responses

- `400` — Bad Request. The quote is in draft status or the requested document type is not supported.
- `403` — Forbidden. Invalid or missing authentication token.

---

[API](https://skmtc.net/dealhub/apis/quote-api.md) · [All operations](https://skmtc.net/dealhub/apis/quote-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dealhub/quote-api/versions/c30f5b9fbfab/schema)