Get Raw Order from TikTok
GET/api/tiktok-shop/integration-instances/:integration_instance_id/orders/:order_id/raw
Fetches the live order JSON directly from the TikTok Shop API (/order/202309/orders?ids=...) for a single previously-synced order. Mirrors the Shopify getRawOrderFromShopify pattern — used by the frontend Raw Data section as a fetch-on-demand tool to inspect the current upstream payload without writing it to the database.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Path params:
tikTokShopIntegrationInstance(required) — integration instance id.tikTokShopOrder(required) — local TikTokShopOrder id.
Returns: { data: <raw TikTok Shop order object> | null }. data is the first element from the upstream orders array, or null if not found.
Request
Responses
- 200
- 401
- 403
- 404
- 429
Successful response
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.