List Duplicate Candidates
GET/api/fulfillment-orders/:fulfillmentOrder/duplicate-candidates
Lists the orders the fulfillment order's shipping provider already holds for the same sales channel order, imported by the provider's own store integration rather than sent by SKU.io. Strongest first.
orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Match strength: strong — the channel's own order id matches, or the order number AND shipping postcode match. possible — only the order number matches (always held for review, never linked automatically).
Cancelled provider orders, provider orders already linked to another fulfillment order, and a provider order waived with Send Anyway are excluded. Returns an empty list for providers without order sync.
deep_link is a URL into the provider's own app when the provider supports it, else null.
Required permission: fulfillment_orders.index. A token also needs its orders scope.
Request
Responses
- 200
- 401
- 403
- 404
- 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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.