Restore Amazon Marketplace Offers
POST/api/v2/sales-channels/:integrationInstance/prices/marketplace-offers/restore
Put back offers that are still at the home-marketplace number in another currency (for example US$78.95 shown as CA$78.95). Runs in the background and returns a tracked job ID to poll.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Requires the integrations.update permission.
Fields:
- marketplaces (required, array, at least 1): one entry per non-home marketplace to restore
- marketplaces.*.country_code (required, string, 2 letters, distinct): the marketplace's country code
- marketplaces.*.method (required, string):
sku— SKU.io sends the converted price once to that marketplace's offers still at the home number, whoever owns the marketplace and without changing the owner (always sent, maximum change waived, other guardrails still apply); orbil— SKU.io sends nothing and re-reads the marketplace to report how many offers are still at the home number, for when you have re-run BIL in Seller Central - marketplaces.*.uplift_pct (optional, number, -50 to 300|null):
skuonly — price with this uplift instead of the marketplace's saved rule. Without it the saved rule is used, or plain conversion when there is none. - dry_run (optional, boolean, default false): price every offer and record the outcome without sending anything
A live sku restore needs a dry-run restore with the same parameters in the last 24 hours, unless SKU.io already prices the marketplace and its current rule has been previewed. Preview first, then run it live.
Returns 202 with data.tracked_job_log_id. Returns 422 for the home marketplace, a country the account does not sell in, or a restore already running or being started for this account; 404 for a sales channel that is not Amazon.
Request
Responses
- 202
- 401
- 403
- 404
- 422
- 429
Accepted
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 Content
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.