List Target Plus Inventory
GET/api/target-plus/:integrationInstance/inventory
Lists one row per listing and distribution center: the quantity SKU.io will send (the mapped warehouse's available stock less safety stock), the quantity Target currently shows, the last quantity pushed and when, and a sync status: synced (in sync), variance (waiting to push), needs_recalc (recalculating), or a reason the row is not pushed: not_mapped (listing not mapped to a SKU.io product), unmapped_dc (distribution center not mapped to a warehouse), excluded_warehouse (a marketplace-fulfilled warehouse, never sent), suspended (suspended by Target). Variation parents are left out.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Filter by distribution center and status with filter_groups (AND/OR conditions) or the flat filter[dc] / filter[status] keys.
Rows of archived listings are excluded unless filter[archived] is sent. Paginated (default 10 per page, max 200); rows are ordered by seller SKU, then distribution center, after any sort.
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.