---
title: "Get Products Pricing"
method: POST
path: "/api/v1/products/pricing"
tags: ["Get Products Information"]
---

# Get Products Pricing

`POST /api/v1/products/pricing`

## Request

- Base URL: `https://api.dealhub.io`
- URL: `https://api.dealhub.io/api/v1/products/pricing`
- Auth: HTTP bearer

This service returns a price for each SKU in the request.

## Request body

- PricingRequest
  - `currency` string, required: The currency ISO code to base the pricing on.
  - `geo` string, required: The geographic region to be used for the pricing calculation.
  - `version` string: The version name to retrieve the parameters for. If not provided, the system will use the active version.
  - `playbook` string: The playbook name in case multiple playbooks exist.
  - `skus` SkuPricingRequest[], required
    - `id` string, required: A unique identifier that represents the ordinal position of this SKU in the request.
    - `sku` string, required: SKU of the product.
    - `parameters` ParameterValue[], required: List of parameters required for price calculation.
      - `name` string, required
      - `value` union, required
        - string
        - number

## Response `200`

Success. Returns the calculated price for each SKU.

- PricingResponse
  - `currency` string: The currency in which the prices are shown.
  - `version` string: The version for which the prices are related.
  - `playbook` string: The playbook name for which the prices are related.
  - `skus` SkuPrice[]
    - `id` string: The identifier that represents the ordinal position as sent in the request.
    - `sku` string: The product's SKU.
    - `price` number: The calculated price per unit in the requested currency (0 if there was an error).
    - `error` string: An error message in case something went wrong (e.g., "Pricing could not be calculated").

## Other responses

- `400`: Bad Request. The request is malformed or a SKU could not be found.
- `403`: Forbidden. The authentication token is missing or invalid.

---

[API](https://skmtc.dev/dealhub/apis/pricing-api.md) - [All operations](https://skmtc.dev/dealhub/apis/pricing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dealhub/apis/pricing-api/revisions/1baa9641a851?raw)
