Skip to main content

List Promotion Listings

GET 

/promotions/:promotionId/listings

Page through the brand's listings in a promotion, or those it offers, with caps, the reference price, overlaps, blockers and the economics at the cap. Eligible reads the marketplace live; the other filters read what Nasam stored and the marketplace's answers to Nasam's writes. Requires promotions.read. Pages are cut by position over rows assembled from the marketplace, so a cursor opens the page after the one that issued it: a row that joins or leaves while you walk can shift a row across the cursor.

Request and response fields at a glance
  • Path parameters: promotionId (integer, required).
  • Query parameters: brandId (integer, required), filter (string, required), search (string), page (integer), limit (integer).
  • 200 response (application/json): listings (array, required), pagination (object, required), readState (string, required), noSignalReason (string or null, required).

Request​