Sign in
Samples

List sample requests

Track sample requests from creators in your shop. Shows only sample-related statuses. Data updates approximately every hour.

Each row includes the requesting creator's bio, categories, and email (sourced from the same regional creators table the AI Creator Search API reads), so consumers can score sample requests on brand/niche fit without a second API call. These fields are null when the creator has no row in the regional creators table.

post/samples/list

Request body

pageinteger
page_sizeinteger
sort_by'updated_at' | 'created_at' | 'gmv' nullable
sort_dir'asc' | 'desc'
start_datestring date nullable
end_datestring date nullable
statusstring nullable
creator_handlestring nullable
product_idstring nullable

Response

Successful Response

currencystring required
{"stackTrail":"components:schemas:SamplesListPaginatedResponse:properties:pagination","oasType":"schema","type":"unknown","title":"Pagination"}
shops_queriedstring[] nullable

Shop names included when querying multiple shops (x-shop-id: all or comma-separated).

Changes

No recorded changes to this endpoint across all 1 revision of this API.