---
title: "Retrieve Real-Time Pricing"
method: POST
path: "/"
tags: ["Callouts"]
---

# Retrieve Real-Time Pricing

`POST /`

> ❗️ Important
>
> This is not an endpoint provided by DealHub. This page present the endpoint definition you need to make available so DealHub can call it.

This endpoint enables DealHub to retrieve real-time product prices and attributes from your external system while a quote is being generated.

The specific URL for this endpoint is configured by the administrator in the DealHub UI.

> 📘 Date Formats
>
> All date and time values are provided in ISO 8601 format and standardized to UTC (Coordinated Universal Time) `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` (e.g., `2025-09-01T15:39:25Z`).

## Request body

- CalloutRequest
  - `request_id` string, required — A unique, randomly generated string to identify the request.
  - `authentication` string — Authentication details passed in the request body. This value mirrors the content of the `Authorization` header.
  - `playbook_answers` object — A key-value map of playbook answers selected by the administrator in the Callout configuration. The keys and value types are customer-specific.
  - `items` Item[], required — List of items (products or bundles) for pricing.
    - `id` integer, required — A unique number that identifies the item within this request. Must be returned in the response.
    - `sku` string, required — The SKU of the product or bundle.
    - `type` 'product' | 'bundle', required — The type of the item.
    - `quantity` number
    - `duration` number
    - `returned_attributes` object — A list of attributes and their expected data types that DealHub is configured to receive for this item. This serves as a guide for the expected response structure.
    - `bundle_items` Item[] — A list of child items. This is mandatory if the `type` is `bundle`.

## Response `200`

Successful response containing the calculated prices and attributes for each item.

- CalloutResponse
  - `items` ResponseItem[], required — The list of items with their calculated prices and attributes.
    - union — An item in the response can be either a single product or a bundle.
      - ProductResponseItem — Common properties for any item returned in the response.
        - `id` integer, required — Same 'id' as sent in the request payload.
        - `sku` string, required — Same 'sku' as sent in the request payload.
        - `MSRP` number, float — Manufacturer's Suggested Retail Price.
        - `partner_discount1` number, float — Partner discount value (e.g., 10 for 10%).
        - `partner_discount2` number, float — Partner discount value (e.g., 10 for 10%).
        - `start_date` string, date-time — A date value, expected in ISO 8601 format (e.g., "2025-09-01T15:39:25Z").
        - `list_price` number, float, required — List price of the line item. This field is mandatory for every product item.
      - BundleResponseItem — Common properties for any item returned in the response.
        - `id` integer, required — Same 'id' as sent in the request payload.
        - `sku` string, required — Same 'sku' as sent in the request payload.
        - `MSRP` number, float — Manufacturer's Suggested Retail Price.
        - `partner_discount1` number, float — Partner discount value (e.g., 10 for 10%).
        - `partner_discount2` number, float — Partner discount value (e.g., 10 for 10%).
        - `start_date` string, date-time — A date value, expected in ISO 8601 format (e.g., "2025-09-01T15:39:25Z").
        - `bundle_items` ProductResponseItem[], required — A list of child items within the bundle. Each item in this list must have a price.
          - `id` integer, required — Same 'id' as sent in the request payload.
          - `sku` string, required — Same 'sku' as sent in the request payload.
          - `MSRP` number, float — Manufacturer's Suggested Retail Price.
          - `partner_discount1` number, float — Partner discount value (e.g., 10 for 10%).
          - `partner_discount2` number, float — Partner discount value (e.g., 10 for 10%).
          - `start_date` string, date-time — A date value, expected in ISO 8601 format (e.g., "2025-09-01T15:39:25Z").
          - `list_price` number, float, required — List price of the line item. This field is mandatory for every product item.

## Other responses

- `400` — Bad Request. An error occurred in the external system. The response should contain a clear error message.

---

[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/revisions/c30f5b9fbfab/schema)