List Target Plus Listings
GET/api/target-plus/:integrationInstance/listings
Lists the integration's Target Plus catalog items (listings), newest first. Each row carries Target's identifiers (seller SKU, TCIN, UPC), the listing status (status.key: pending, approved, approved_update_pending, rejected, suspended, unlisted, other) with a plain-language explanation, any errors Target reported, offer / list / MAP prices, quantity per distribution center, the linked SKU.io product once mapped, and a price-parity note when the Target price is above the product's Shopify price.
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Archived listings are excluded unless an archived filter is sent. Paginated (default 10 per page).
Each listing carries publishing: SKU.io's item submission for the item — status (queued, submitted, approved, rejected, failed), queued_at / submitted_at / resolved_at, last_error (why a queued item is waiting), listing_draft_id (the draft to edit and publish again), can_resubmit (true for an item Target rejected; Target's reasons are in errors[].partner_action), is_queued and review_message.
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.