Skip to content

Get Price Book Entry Adjustment

GET https://api.secure.quotivity.com/v1/pricebooks/{priceBookId}/products/{productId}/adjustment

Retrieves the adjustment for a product in a price book for a specific currency.

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

Name Type Required Description
priceBookId string Yes —
productId string Yes —
Name Type Required Description
currency string Yes —
Status Body Description
200 GetPriceBookEntryAdjustmentResponse Adjustment retrieved successfully
401 — Unauthorized
500 — Internal Server Error

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.
Field Type Required Description
adjustment PriceBookEntryAdjustmentWithResponseFlags Yes —

Extends PriceAdjustmentBase.

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

Extends PriceAdjustmentBase.

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

Type: OverrideAdjustment | PercentAdjustment | CostPlusAdjustment | VolumeAdjustment | TableEnumAdjustment | TableRangeAdjustment | VariantAdjustment

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.

Extends PriceAdjustmentBase.

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

Extends PriceAdjustmentBase.

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

Extends PriceAdjustmentBase.

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

Extends PriceAdjustmentBase.

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