List Amazon Business Offers
GET/api/v2/sales-channels/:integrationInstance/prices/business/offers
List this account's Amazon Business offers as SKU.io last read them from Amazon — one row per seller SKU, marketplace and audience — with the live consumer and Business prices, the quantity discounts, what the next price push would send, and flags for offers that need attention.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Requires the integrations.show permission (API tokens: integrations:read scope).
Offers are read daily and by Sync Amazon Business Offers; checked_at says when each was last seen.
Search. filter[search] looks in the offer ID (exact match), seller SKU, ASIN, product SKU and product name (partial match). search_columns limits it to some of id, seller_sku, asin, product_sku and product_name, and search_strict_columns makes the listed columns match exactly.
Filters. filter[status], filter[country_code], filter[managed], filter[audience], filter[override], filter[margin] and filter[archived] as listed in the parameters. Advanced filters use filter[<column>.<operator>] and also work inside filter_groups:
- text (
contains,does_not_contain,is,is_not,is_one_of,is_not_one_of,starts_with,does_not_start_with,ends_with,does_not_end_with,is_empty,is_not_empty): seller_sku, asin, country_code, audience, currency, product_sku, product_name - number (
is,is_not,is_one_of,is_not_one_of,greater_than,less_than,greater_than_or_equal,less_than_or_equal,between,is_empty,is_not_empty): id, product_listing_id, consumer_price, business_price, last_submitted_price, business_vs_consumer_pct - yes/no (
is): is_above_consumer, has_rung_below_floor, has_non_discount_rung - date-time (
is,is_not,before,after,on_or_before,on_or_after,between,is_empty,is_not_empty,today,yesterday,past_week,past_month,past_year,days_ago,past_daysand the future equivalents): checked_at, confirmed_at, last_submitted_at
Response rows (data[]):
- id (the Business offer ID used by Neutralise Amazon Business Offers), product_listing_id, product_id, product_sku, product_name (null when the offer is not linked to a listing), listing_archived
- asin_product (object|null): unlinked offers only — the SKU.io product another of this account's offers on the same ASIN is linked to (for example an Amazon Grade and Resell
amzn.gr.SKU), as{product_id, product_sku, product_name, seller_sku}whereseller_skuis that linked offer's; null for a linked offer or when no offer on the ASIN is linked. Nothing is linked by it. - seller_sku, asin, marketplace_id, country_code, marketplace_label, currency
- audience (string):
B2B(Amazon Business) orBZR(industry pricing — shown for reference; SKU.io never writes it) - consumer_price, business_price (number|null): the live prices as last read, in the marketplace currency.
business_priceis null on ano_offerrow — a placeholder for a listing SKU.io prices that has no Business offer on Amazon yet, which the next push can create - business_vs_consumer_pct (number|null): the Business price against the consumer price, in percent; positive means the Business price is higher
- quantity_discount_plan (object|null): the live ladder —
{discount_type, levels[]};discount_typeispercentorfixed, each level is{min_quantity, value, price}wherevalueis what Amazon holds (percent off the Business price, or a unit price) andpricethe unit price a buyer of that quantity pays - would_send (object|null): what the next price push would send —
{business_price, levels[{min_quantity, price}], discount_type, plan_action, detail, verdict}.plan_actionisset(sendlevels),clear(remove the ladder) orleave(send no ladder).verdictissend,unchanged,skippedorfailed. Null when SKU.io does not price this offer. - flags (array of strings): any of
above_consumer,rung_below_floor,non_discount_rung,unmanaged,pending_confirmation(sent, not yet seen on Amazon),in_sync(Amazon shows what was last sent, or nothing was sent),overridden_elsewhere(on 3 syncs in a row Amazon showed something other than what SKU.io last sent — usually a Seller Central rule or another tool changing it),business_override(the listing or its product has its own Business policy),no_offer,not_enrolled,industry_pricing - managed (boolean): SKU.io prices this offer — the marketplace's Business owner is
skuand the account is enrolled there, the offer is linked to an active listing, the listing's policy has a Business price, and eithersku_master_of_priceorchannel_anchoredis true - business_override (object|null): the listing's or product's own Business policy on this account, when it has one —
{id, scope, mode, mode_label, percent_off, quantity_discount_mode, business_pricing, updated_at};scopeislistingorproduct - business_source (string): where the listing's Business policy comes from —
listing_override,product_override,profileorchannel, in that order of precedence - sku_master_of_price (boolean): SKU.io is the listing's effective master of price (the listing's own setting, else the channel's). When false, SKU.io sends no consumer price for it, and no Business price unless
channel_anchoredis true - channel_anchored (boolean): the listing's effective master of price is the sales channel (Amazon sets the consumer price, for example through a Seller Central repricing rule) and the offer is in the home marketplace, the listing's own. SKU.io still prices its Business offer, from the consumer price Amazon was last read holding (the newer of the Business offer sync's and the listing reconciliation's readings). When that reading is missing or more than 48 hours old, the Business price is skipped with the reason
- owner (string): the marketplace's Business owner,
skuorchannel; enrolled (boolean|null) - status (string):
active, orgoneonce the offer has been missing from 3 complete syncs in a row; missed_syncs (integer) - last_submitted_price, last_submitted_at: the last Business price SKU.io sent; confirmed_at: when Amazon last showed the offer matching it; checked_at: when the offer was last read
Returns 422 when per_page is above 100 or filter[archived] is not active, archived or all.
Margin. Each row carries margin_pct: the listing's margin after product cost and channel fees. When the listing sold at least 5 units on closed, fulfilled orders in the last 12 months it is the actual margin on those orders (margin_source: actual, margin_units: units sold). Otherwise it is projected from the consumer price, the product's cost, landed cost and shipping, and the fee share (the product's own marketplace fee %, else the channel's actual fee share over the same 12 months) (margin_source: projected). It is null when nothing can be measured, or when the offer's price is in a currency other than the account's base currency. Filter with filter[margin] (min:max), filter[margin_min], filter[margin_max] or the advanced filter[margin_pct.<operator>]; sort with margin_pct (offers without a margin sort last either way).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.