Skip to main content

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.

Required scope: integrations:read

Grant 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_days and 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} where seller_sku is 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) or BZR (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_price is null on a no_offer row — 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_type is percent or fixed, each level is {min_quantity, value, price} where value is what Amazon holds (percent off the Business price, or a unit price) and price the 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_action is set (send levels), clear (remove the ladder) or leave (send no ladder). verdict is send, unchanged, skipped or failed. 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 sku and the account is enrolled there, the offer is linked to an active listing, the listing's policy has a Business price, and either sku_master_of_price or channel_anchored is 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}; scope is listing or product
  • business_source (string): where the listing's Business policy comes from — listing_override, product_override, profile or channel, 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_anchored is 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, sku or channel; enrolled (boolean|null)
  • status (string): active, or gone once 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​

OK

Response Headers
    Content-Type