Get Supplier Prep Performance Metrics
GET/api/tiktok-shop/fbt/suppliers/:supplier/3pl-metrics
The same prep-performance metrics scoped to one source supplier.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
This endpoint is deliberately not scoped to an integration instance: a partner's turnaround spans every TikTok Shop account they prep for.
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.
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.