Get Product Prices

GET https://api.secure.quotivity.com/v1/products/{productId}/prices

Retrieves all defined prices for a product

Send your API key in the x-api-key header. See Generating API keys.

Path parameters

Name	Type	Required	Description
`productId`	string	Yes	—

Responses

Status	Body	Description
`200`	ProductPriceDetails	Successfully retrieved product prices
`400`	—	Invalid product
`401`	—	Unauthorized
`500`	—	Internal Server Error

Schemas

CostPlusAdjustment

Derives the list price from the product’s hs_cost_of_goods_sold: basis amount adds value to cost; basis percent applies value as a fraction of cost (0.3 = 30%) as a markup (cost × (1 + value)) or a margin (cost ÷ (1 − value)). Non-primary currencies convert the cost with the account’s cached HubSpot exchange rate. value must not be negative and a margin must be below 1. Requires the Cost Plus feature (Enterprise).

Extends PriceAdjustmentBase.

Field	Type	Required	Description
`type`	`costplus`	Yes	—
`basis`	`amount` \| `percent`	Yes	—
`mode`	`markup` \| `margin`	No	Read only when `basis` is `percent`; defaults to `markup`.
`value`	number	Yes	Currency amount above cost for `amount`; fraction of cost for `percent`.
`round`	boolean	No	Round the derived price to 2 decimals (default true); `false` keeps 5 decimals.

OverrideAdjustment

Extends PriceAdjustmentBase.

Field	Type	Required	Description
`type`	`override`	Yes	—
`amount`	number	Yes	—

PercentAdjustment

Extends PriceAdjustmentBase.

Field	Type	Required	Description
`type`	`percent`	Yes	—
`amount`	number	Yes	—

PriceAdjustmentBase

Field	Type	Required	Description
`type`	string	Yes	—

PriceBookEntryAdjustment

PriceBookEntryAdjustmentWithResponseFlags

Per-currency adjustment as stored, plus allowUnitPriceEditing mirrored from the price book entry in read responses (not part of the persisted adjustment object).

Extends PriceBookEntryAdjustment.

Field	Type	Required	Description
`allowUnitPriceEditing`	boolean	Yes	Entry-level flag for this product on the price book.

ProductPriceDetails

Field	Type	Required	Description
`productId`	string	Yes	—
`prices`	ProductPrices[]	Yes	—
`standardPrice`	map of string to number	Yes	Price per currency. Keyed by ISO 4217 currency code (for example `USD`, `EUR`). A currency is absent, or null, when no price is set.
`properties`	map of string to string	Yes	—

ProductPrices

Field	Type	Required	Description
`priceBookId`	string	Yes	—
`priceBookName`	string	Yes	—
`listPrice`	map of string to number	Yes	Price per currency. Keyed by ISO 4217 currency code (for example `USD`, `EUR`). A currency is absent, or null, when no price is set.
`standardPrice`	map of string to number	Yes	Price per currency. Keyed by ISO 4217 currency code (for example `USD`, `EUR`). A currency is absent, or null, when no price is set.
`adjustments`	map of string to PriceBookEntryAdjustmentWithResponseFlags	Yes	Price adjustments keyed by ISO 4217 currency code (for example `USD`, `EUR`). The key is the currency; the value carries the adjustment only.

TableEnumAdjustment

Extends PriceAdjustmentBase.

Field	Type	Required	Description
`type`	`enum`	Yes	—
`property`	string	Yes	—
`values`	object[]	Yes	—

TableRangeAdjustment

Extends PriceAdjustmentBase.

Field	Type	Required	Description
`type`	`range`	Yes	—
`property`	string	Yes	—
`values`	object[]	Yes	—

VariantAdjustment

Extends PriceAdjustmentBase.

Field	Type	Required	Description
`type`	`variant`	Yes	—
`values`	object[]	Yes	—

VolumeAdjustment

Extends PriceAdjustmentBase.

Field	Type	Required	Description
`type`	`volume`	Yes	—
`tiers`	object[]	Yes	—