Get Creator Sample Application Detail

POST

/affiliate_creator/202412/sample_applications/single_query

Get the sample detail of specified sample application.

Authorizations

• accessToken

Request Body^required

Media typeapplication/json

object

product_id

required

The product identifier.

string

application_id

Free sample application ID. When application_type is FREE_SAMPLE, provide application_id; if it is omitted, provide main_order_id in addition to the required product_id.

string

application_type

required

The type of creator sample application.

• FREE_SAMPLE : free sample supplied by seller which creator can apply for by themselves from product detail page.
• SAMPLE_COUPON: creator claimed sample coupon (a type of coupon) and used it to place orders at a discount price.
• SAMPLE_CAMPAIGN: activity organized by the platform. Creators can participate in this activity to obtain sample products provided by the platform for free.

string

main_order_id

The real main order identifier, required when application is “SAMPLE_COUPON” or “SAMPLE_CAMPAIGN” or “REFUNDABLE_SAMPLE”.

string

Example

{
  "product_id": "1729480364147774364",
  "application_id": "8070590921506065183",
  "application_type": "FREE_SAMPLE",
  "main_order_id": "579622078763731743"
}

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

sample_application

The sample application information.

object

id

Sample application identifier.

string

create_time

Sample application create time in seconds.

integer format: int64

sample_product

The sample product information.

object

id

The product identifier.

string

sku_id

The SKU identifier.

string

sku_sale_property_value_names

Sku property name list for this sku id.

Array<string>

main_order_id

The sample order is generated after the sample application is approved by seller.

string

activity_id

The sample activity identifier id( only for sample campaign).

string

type

The type of creator sample application.

• FREE_SAMPLE : free sample supplied by seller which creator can apply by themselves from pdp page.
• SAMPLE_COUPON: creator claimed sample coupon (a type of coupon) and used it to purchase orders at a discount price.
• SAMPLE_CAMPAIGN: activity organized by the platform. Creators can participate in this activity to obtain sample products provided by the platform for free.

string

status

The status of sample applications. The possible enumerated values are:

• PENDING: The sample application is waiting for the seller’s review.
• AWAITING_SHIPMENT: The application is approved, and the seller needs to ship the sample.
• SHIPPED: The sample has been shipped by the seller and is waiting for the creator to receive the package.
• CONTENT_PENDING: The creator has received the sample package and is expected to create content.
• REJECT_CANCELLED: The sample application has been rejected by the seller.
• OVERDUE_CANCELLED: The sample application has expired due to being overdue.
• UNFULFILL_CANCELLED: The creator did not fulfill the commitment to create content within the agreed timeframe.
• SELLER_NOT_SHIP_CANCELLED: The seller did not ship the sample within the required timeframe.
• WITHDRAW_CANCELLED: The creator withdrew the sample application before the seller approved it.
• UNFULFILLABLE_CANCELLED: The application was cancelled due to reasons beyond the creator’s control, making it impossible to create content.
• OPS_CANCELLED: The application was manually cancelled by operations staff.
• OPS_FAILED: The application was marked as failed by operations staff.
• OPS_ COMPLETED: The application was manually marked as completed by operations staff.
• COMPLETED: The application is complete, and the creator has posted the content. This field allows for tracking the status of a sample application throughout its lifecycle, providing visibility into each stage of the process for sellers and creators.

string

creator_fulfillment

Fulfillment info for this sample application.

object

id

Fulfillment identifier.

string

expiration_time

Fulfillment deadline timestamp, in seconds.

integer format: int64

total_suspend_duration

Total suspension duration for fulfillment, in seconds.

integer format: int64

status

Fulfillment status, It indicates the current status of the fulfillment process. The possible values are:

• PENDING: The creator is yet to fulfill the content creation obligation.
• ONGOING: Fulfillment is in progress; content has been created and is being evaluated against criteria.
• SUCCEED: Fulfillment has been successfully completed; the content meets the required standards.
• FAILED: Fulfillment failed; the content did not meet the required standards.
• OVERDUE: Fulfillment is overdue; the creator did not meet the deadline.
• SUSPEND: Fulfillment has been suspended.
• CANCELLED: Fulfillment has been cancelled, either by the creator or due to operational reasons.
• EXEMPTED: The creator has been exempted from the fulfillment obligation.
• REPEATED: The creator repeated the fulfillment after initially completing it; repeated fulfillment is not treated as a failure.

string

Allowed values: PENDING ONGOING SUCCEED FAILED OVERDUE SUSPEND CANCELLED EXEMPTED REPEATED

Example

{
  "code": 0,
  "data": {
    "sample_application": {
      "id": "8070590921506065183",
      "create_time": 1731298837,
      "sample_product": {
        "id": "1729863469568985219",
        "sku_id": "1729480364147774364",
        "sku_sale_property_value_names": [
          "red",
          "large size"
        ]
      },
      "main_order_id": "57871819384716917",
      "activity_id": "74378918272345199",
      "type": "FREE_SAMPLE",
      "status": "PENDING",
      "creator_fulfillment": {
        "id": "87147319238415178",
        "expiration_time": 1726301400,
        "total_suspend_duration": 7641234,
        "status": "PENDING"
      }
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}