Smart Match SKU Product

POST 
/api/magento2/integration-instances/:magento2IntegrationInstance/products/:product/smart-match

Suggest SKU.io products that could be mapped to this Magento 2 product. Returns three buckets:

• exact_match — the SKU.io product whose sku is identical to the Magento product's SKU (or null if no match).
• barcode_match — the SKU.io product whose barcode matches the Magento product's barcode (or null).
• similar_matches — fuzzy name/SKU matches, capped by limit.

Body (optional):

• query (string, max 255) — free-text search term. When omitted, the manager seeds the search with the Magento product's name (falling back to sku).
• limit (integer, 1–50) — max similar matches to return. Defaults to 10.

Error responses:

• 404 — product does not exist OR belongs to a different instance.
• 422 — validation failed on query or limit.

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.

429

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.