Skip to main content

Check Amazon Business Enrollment

POST 

/api/v2/sales-channels/:integrationInstance/prices/business/enrollment-check

Ask Amazon whether this seller account is enrolled in Amazon Business in each marketplace, store the answer, and return the account's Business pricing.

Required scope: integrations:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token.

Requires the integrations.update permission (API tokens: integrations:write scope).

Request body (all optional):

  • country_codes (array of strings|null, max 20): two-letter country codes of the marketplaces to check. Omit or send null to check every marketplace this account sells in. A code the account does not sell in returns 422 on country_codes.{index}.
  • force (boolean, default true): ask Amazon even when a marketplace was checked in the last 24 hours. Send false to re-check only the marketplaces whose answer is missing or stale.

A marketplace Amazon could not be reached for keeps its previous answer and reports the failure in enrollment_error; the request itself still succeeds.

Returns the same data as Get Amazon Business Pricing, plus a confirmation message.

Response data:

  • settings (object): the channel's own Business pricing policy, as saved with Update Price Push Settings (business). A pricing sync profile with its own business_pricing replaces it for the listings the profile governs.
  • dry_run_pending (boolean): a Business price was just turned on, so the next price push previews its Business prices instead of sending them. A completed push clears it.
  • marketplaces (array): one row per marketplace this account sells in — see below
  • last_sync (object|null): the last Business offer sync — {completed_at, status, offers}; status is completed, partial (stopped before reading every offer) or cancelled
  • sync_running (boolean): a Business offer sync is in progress
  • sync_job_name (string): the tracked job name of this account's Business offer sync, for finding a running one
  • overrides (object): Business overrides on this account — {total, products, listings, managed}; managed counts those that turn a Business price on. See List Amazon Business Overrides.

Each marketplaces[] row (home marketplace first):

  • country_code, marketplace_id, label, currency, is_home
  • enrolled (boolean|null): whether this seller account can sell to Amazon Business customers in the marketplace; null until it has been checked
  • audiences (array of strings): the offer audiences Amazon allows this seller there, e.g. ALL (consumer), B2B (Amazon Business) and BZR (industry pricing). enrolled is true when B2B is present.
  • checked_at (string|null), enrollment_error (string|null): when enrollment was last read, and the error if the last attempt failed (the previous answer is kept)
  • enrollment_stale (boolean): the answer is missing or older than a day — call Check Amazon Business Enrollment to refresh it
  • owner (string): who prices the Business offer — channel (Seller Central; the default) or sku (SKU.io)
  • owner_changed_by (string|null), owner_changed_by_user_id (integer|null), owner_changed_at (string|null): who last changed owner, and when
  • consumer_owner (string): who prices the consumer offer there — sku or channel. On the home marketplace it follows the channel's master of price; elsewhere, the marketplace's owner in Amazon International Pricing.
  • can_take_over (boolean), take_over_blocked_reason (string|null): whether owner can be set to sku now, and why not
  • counts (object): live Business offers in the marketplace — business_offers, above_consumer (Business price above the consumer price), rung_below_floor (a quantity-discount price below the floor), non_discount_rung (a quantity-discount price not below the Business price), unmanaged (offers SKU.io does not price), confirmed (offers whose live price Amazon has confirmed), would_move (an estimate of how many offers SKU.io would price whose live Business price is more than 10% away from what their policy would set: the target is the consumer price Amazon last showed less the policy's percent off, ignoring rounding, guardrails and the next consumer price; offers priced from pricing levels count only when they carry an attention flag) and checked_at (the newest read)

Request​

Responses​

OK

Response Headers
    Content-Type