Skip to main content

List Guardrail Exceptions

GET 
/api/v2/sales-channels/:integrationInstance/prices/guardrail-overrides

Lists every listing-level exception to this channel's price guardrails.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

An exception supplies the WHOLE guardrail set for its target — floor, ceiling, maximum change and the action taken when the change limit is exceeded. It does not inherit individual fields from the channel. A listing exception replaces the channel's guardrails for that listing.

Authentication: requires a Bearer token.

Filters:

  • filter[search] — matches the exception ID exactly
  • filter[id], filter[max_delta_pct], filter[floor_value] — numeric operators
  • filter[created_at], filter[updated_at] — datetime operators
  • filter_groups — base64-encoded condition tree for compound AND/OR filtering

Allowed sorts: id, created_at, updated_at, floor_value, max_delta_pct. Prefix with - for descending. Default sort: -updated_at.

Pagination: page and per_page (default 10, maximum 200).

Pricing-level bounds. floor_type / ceiling_type also accept tier, which reads the bound from the product's price in the pricing level named by floor_tier_id / ceiling_tier_id (MAP and MSRP are the usual cases). A product with no price in that level simply has NO bound — it is not blocked, unlike a margin_pct rule on a product with no landed cost.

floor_action / ceiling_action choose what happens when a price violates the bound: adjust moves the price to the bound and transmits it, block refuses the listing. Omit them (or send null) to get the type's default — adjust for tier, block for amount and the percentage types. An adjusted price is reported as a pushed line whose detail names the bound that moved it, and the maximum-change limit is measured on the ADJUSTED figure.

Request​

Responses​

OK

Response Headers
    Content-Type