Marketing promotion or sale campaign offering percentage discounts. Contains promotion details, discount percentage, active period, and status for promotional campaigns.
https://api.mockly.codes/promotions?page=1&limit=10&count=10Configure your request and click Send Request to see the response here.
/promotionsGet a collection of promotions
/commerce/promotions/promotions/:idGet a single promotion by ID
/commerce/promotions/:id/promotions/metaGet resource metadata and schema
/commerce/promotions/metaThe search feature allows you to filter results by searching for text across all or specific fields. Choose between ?q= or ?search= parameter names.
Search across all text fields:
GET https://api.mockly.codes/promotions?q=laptopGET https://api.mockly.codes/promotions?q=laptop&search_fields=name,descriptionsearch_fields, all text fields are searched// Get 10 promotions
fetch('https://api.mockly.codes/promotions?count=10')
.then(res => res.json())
.then(data => console.log(data));import requests
response = requests.get(
'https://api.mockly.codes/promotions?count=10'
)
data = response.json()curl "https://api.mockly.codes/promotions?count=10"fetch('https://api.mockly.codes/promotions?nocache=true')idintegerUnique identifier for the promotion
random_inttitlestringPromotional title or campaign name (e.g., Summer Sale, Black Friday, Holiday Special)
sentencedescriptionstringDetailed description of the promotion, terms, and eligible products
paragraphdiscount_percentagenumberDiscount percentage offered (typically 5-50%)
floatstart_datestringDate when the promotion becomes active
past_datedateend_datestringDate when the promotion expires
future_datedateactivebooleanWhether the promotion is currently active and available
booleancountintegerNumber of items to return (default: 10, max: 100)
seedintegerSeed for reproducible data generation
nocachebooleanBypass cache and generate fresh data on every request