Get Submission Records

GET

/product/202604/opportunities/submissions

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.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

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

integer format: int64

Return submissions created at or after this Unix timestamp, in seconds.

submit_time_lt

integer format: int64

Filter submissions created before this time, second-level timestamp

page_token

string

Pagination token from previous response. Omit for first page.

page_size

required

integer format: int64

<= 100

Number of results per page. Max: 100. Default: 20.

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

data

The submission records and pagination information returned for this request.

object

submissions

List of submission records.

Array<object>

object

id

Unique ID of this submission.

string

opportunity_id

The opportunity ID this submission is linked to.

string

opportunity_title

Opportunity title for reference.

string

status

Current status: PENDING_REVIEW / APPROVED / REJECTED

string

product_id

The submitted product ID.

string

product_name

Product name for reference.

string

submit_time

The time when the product was submitted, expressed as a Unix timestamp in seconds.

integer format: int64

review_time

Review completion timestamp

integer format: int64

rejection_reason

Rejection reason if status is REJECTED. Null otherwise.

string | null

product_orders

The total number of units sold for the product in the last 30 days.

integer format: int64

product_pv

The product page view count for the last 30 days.

integer format: int64

next_page_token

Token for fetching next page. Empty if no more pages.

string

total_count

Total number of matching submissions (approximate).

integer format: int64

Example

{
  "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
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}