Get Inbound Order Labels
GET/api/tiktok-shop/:integrationInstance/fbt/inbound-orders/:order/labels
Asks TikTok to produce this inbound order's carton labels, packing list and unit barcodes.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
The print operation is asynchronous. A ready: false answer with task_status of PROCESSING is normal — poll this endpoint until ready is true, then call Download Inbound Order Labels for the file.
Permission: none beyond a valid token.
Query parameters
print_items[]— optional array, at least one entry when supplied. Each value must be CARTON_LABEL, PACKING_LIST or FBT_BARCODE. Defaults to CARTON_LABEL.carton_label_format— optional. DEFAULT_1UP or A4_4UP.barcode_format— optional. DEFAULT_40MM_60MM.
Requires integrations.update. Despite being a GET this MUTATES — it opens an operation row, creates a print task at TikTok and persists it onto the order. labels/download is the read.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 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.
Unprocessable Content
Response Headers
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.