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).