REreacherapp
Samples

List sample requests

Changed on

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

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/samples/list
  • Auth
    API key in header x-api-key and API key in header x-shop-id

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

Filter by status. Accepts the labels returned in status (Sample Requested, Sample Approved, Sample Shipped, Content Pending, Completed, Sample Rejected, Sample Request Expired, Sample Cancelled, Content Unfulfilled, Idle), the pseudo-statuses Posted Video, Sold Products, Showcasing Product, Livestreamed, and the aliases pending, approved, shipped, rejected, expired, cancelled. Case-insensitive; an unrecognised value is rejected.

creator_handlestring nullable
product_idstring nullable

Response

Successful Response

currencystring required
paginationunknown required
shops_queriedstring[] nullable

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

Changes

  • f1e4419af264Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 291230805105Revision changes
    • info

      api operation id samples_list_samples_list_post removed and replaced with samples_list