List Inbound Plan Items
GET/api/tiktok-shop/:integrationInstance/fbt/inbound-plans/:plan/items
The plan's lines, each with the product name and the packed-versus-planned counts.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
packed_quantity is the sum of that line's carton contents and is_fully_packed is true only when it equals quantity — the same conservation rule enforced when the plan is submitted. match_status / is_matched say whether the shop SKU is bound to an FBT goods record; an unmatched line cannot be inbounded.
Returns the complete list — this endpoint is not paginated.
The plan must belong to the integration instance in the path; a plan owned by another instance answers 404.
Requires an authenticated token. No extra permission is needed for this read.
available_quantity on each line is the source warehouse's free stock plus any Send Planner hold already placed for that line, so stock the planner held for this draft never reads as "more than available".
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.