Sign in
Analytics

CRM v2 sample-request rows

The paginated sample-request pipeline for one shop — the rows behind the Sample Requests board. Each row carries the creator (handle, followers, level, rising-star / fast-growing signals, CRM tags), the product, the request's status and timestamps, and the creator's performance metrics (post rate, PPS score, average views, engagement rate, GMV per sample, videos per sample).

Filter by pipeline tab (status), product, creator profile, sourcing automation, tag, date range, free-text search, and any of the metric ranges (min_* / max_*). show_archived returns the archived board instead; show_expiring narrows to requests about to expire. Response also reports archivedCount, expiringCount and a dataFreshness stamp.

Single-shop only, and only for shops on the CRM v2 pipeline — others get a 404 and should use /samples.

get/funnel/v2/requests

Query parameters

pageinteger

Page number, 1-based.

Page number, 1-based.

page_sizeinteger

Rows per page (max 100).

Rows per page (max 100).

statusstring nullable

Pipeline tab to filter to. One of: toReview, readyToShip, shipped, pendingContent, completed, cancelled.

Pipeline tab to filter to. One of: toReview, readyToShip, shipped, pendingContent, completed, cancelled.

product_idsstring nullable

Comma-separated product IDs.

Comma-separated product IDs.

profile_idsstring nullable

Comma-separated creator profile IDs.

Comma-separated creator profile IDs.

automation_idsstring nullable

Comma-separated automation IDs that sourced the request.

Comma-separated automation IDs that sourced the request.

tagsstring nullable

Comma-separated CRM tags.

Comma-separated CRM tags.

created_fromstring nullable

Earliest request date, YYYY-MM-DD (inclusive).

Earliest request date, YYYY-MM-DD (inclusive).

created_tostring nullable

Latest request date, YYYY-MM-DD (inclusive).

Latest request date, YYYY-MM-DD (inclusive).

searchstring nullable

Free-text search over creator handle / name.

Free-text search over creator handle / name.

sort_bystring

Sort field.

Sort field.

sort_directionstring

'asc' or 'desc'.

'asc' or 'desc'.

exclude_rejectedboolean

Drop rejected requests.

Drop rejected requests.

show_archivedboolean

Return archived requests instead.

Return archived requests instead.

show_expiringboolean

Only requests expiring soon.

Only requests expiring soon.

min_post_ratenumber nullable
max_post_ratenumber nullable
min_pps_scorenumber nullable
max_pps_scorenumber nullable
min_avg_viewsnumber nullable
max_avg_viewsnumber nullable
min_engagement_ratenumber nullable
max_engagement_ratenumber nullable
min_live_gmvnumber nullable
max_live_gmvnumber nullable
min_shop_gmvnumber nullable
max_shop_gmvnumber nullable
min_creator_gmvnumber nullable
max_creator_gmvnumber nullable
min_avg_gmv_videonumber nullable
max_avg_gmv_videonumber nullable
min_gmv_samplenumber nullable
max_gmv_samplenumber nullable
min_videos_per_samplenumber nullable
max_videos_per_samplenumber nullable

Response

Successful Response

expiringCountinteger
lastUpdatedAtstring nullable

Changes

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