---
title: "Get a List of Quotes"
method: GET
path: "/api/v2/quotes"
tags: ["Quote Management"]
---

# Get a List of Quotes

`GET /api/v2/quotes`

Retrieves a list of quotes, with options for filtering and pagination. 

Use the `external_opportunity_id` query parameter to retrieve only the quotes linked to a specific opportunity in your CRM.

The level of detail returned for each quote is controlled by the `feature` query parameter.

Use the `offset` and `limit` parameters to page through large sets of quotes. The default `limit` is 50 quotes per request.

If no quotes match the specified criteria, the API will return a `200 OK` status with an empty `quotes` array.

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

## Query parameters

- `external_opportunity_id` string
- `feature` string[]
- `offset` integer
- `limit` integer

## Response `200`

Success. Returns a paginated list of quotes.

- PaginatedQuotesResponse
  - `info` PaginationInfo
    - `more_results_matching_the_request` boolean
    - `offset` string
    - `limit` string
  - `quotes` 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

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