Get Raw Transaction from TikTok
GET/api/tiktok-shop/integration-instances/:integration_instance_id/transactions/:transaction_id/raw
Fetches the live transaction JSON directly from the TikTok Shop Finance API for a single previously-synced transaction. It reads the parent statement's transactions via GET /finance/202309/statements/{statement_id}/statement_transactions (paginated via page_token, sort_field=order_create_time) and returns the entry whose id matches the stored tiktok_transaction_id. Mirrors the Get Raw Order from TikTok 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. Must own the transaction, otherwise403is returned.tikTokShopTransaction(required) — local TikTokShopTransaction id. Must have a storedstatement_id, otherwise422is returned.
Returns: { data: <raw TikTok Shop statement transaction object> | null } (null when no matching row is found on the statement).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
Successful response
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
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.