GET Get Submission Records
Get Submission Records Shop Required scope: seller.product.basic Retrieve a paginated list of submission records for the authorized seller, including submission status, review results, and linked opportunity/product information. Useful for tracking submission history and monitoring review outcomes. Version 202604
GET/product/202604/opportunities/submissions
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| status | string | Filter by submission status: PENDING_REVIEW / APPROVED / REJECTED. Leave empty to return all statuses. |
| opportunity_id | string | Filter by specific opportunity ID. |
| product_id | string | Filter by specific product ID. |
| submit_time_ge | int | Filter submissions created after this time, second-level timestamp |
| submit_time_lt | int | Filter submissions created before this time, second-level timestamp |
| page_token | string | Pagination token from previous response. Omit for first page. |
| page_size Required | int | Number of results per page. Max: 100. Default: 20. |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Example
CurlGoNode.jsJavaEnable word wrap
1234curl-XGET 'https://open-api.tiktokglobalshop.com/product/202604/opportunities/submissions?page_size=20&status=APPROVED&product_id=7298374612938475620&submit_time_ge=1775973876&page_token=100&opportunity_id=7123456789012345678&submit_time_lt=1776973876&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json'
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
{"code":0,"data":{"data":{"submissions":[{"id":"8001234567890123456","opportunity_id":"7123456789012345678","opportunity_title":"Women's High-Waist Yoga Leggings","status":"APPROVED","product_id":"7298374612938475620","product_name":"Premium Yoga Leggings - Black","submit_time":1775973876,"review_time":1775973876,"rejection_reason":"Product does not match the opportunity category requirements","product_orders":121,"product_pv":320}],"next_page_token":"100","total_count":300}},
Error Code
View common error codes
| Code | Message | | --- | --- | | Empty. No business logic error codes. |
Is this content helpful?Helpful
Not Helpful
PreviousNext