Get Prep Performance Metrics
GET/api/tiktok-shop/fbt/inbound-orders/3pl-metrics
Prep-performance metrics across every 3PL and supplier that handled FBT inbound work.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Turnaround metrics for the 3PLs and suppliers that prep FBT inbound shipments: for each partner, how long they took after the handoff was sent to open the link, submit the carton contents, and report the shipment ready.
Every duration is in hours. A null value means the milestone was never reached. A handoff sent more than 168 hours ago and still not ready counts toward overdue_count.
summary aggregates every partner in scope; partners breaks the same figures out per partner, ordered by the number of handoffs sent.
Only handoffs that were actually sent are counted.
Query parameters
date_from— optional, nullable date.date_to— optional, nullable date.
Permission: none beyond a valid token.
Not instance-scoped. A partner's turnaround spans every TikTok instance, so this route carries no {integrationInstance} segment — it previously did, which advertised a scope nothing enforced.
Request
Responses
- 200
- 401
- 403
- 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.
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.