List Inbound Products
GET/api/tiktok-shop/:integrationInstance/fbt/inbound-products
Look up shop SKUs for the inbound builder, annotated with everything that decides whether they can actually be sent to Fulfillment by TikTok.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Query parameters
query(string, optional, nullable, max 255) — partial match on seller SKU, product name or TikTok SKU id.source_warehouse_id(integer, optional, nullable) — when given, each row reportssource_available_quantityandsource_on_hand_quantityat that warehouse. When omitted both arenullrather than zero, because unknown and none are different answers.matched_only(boolean, optional) — return only SKUs already bound to an FBT goods record.
match_status is matched or unmatched; an unmatched SKU has no goods record behind it and cannot be inbounded until it is bound. is_hazmat, is_lot_code, is_expiration_management and requires_lot_or_expiry come from the bound goods record and govern what carton contents must declare.
Returns at most 50 rows, ordered by seller SKU — this is a type-ahead lookup, not a report.
Requires an authenticated token. No extra permission is needed for this read.
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.