GET /v1/promotions/coupon-definitions
A typed selector for marketing coupon grants. It deliberately returns definitions rather than coupon codes: generated codes are bound to a customer when the trusted marketing trigger fires.
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
statusquery · stringlimitquery · integer
cURL
curl --request GET 'https://nexus-api.rainlib.com/v1/promotions/coupon-definitions' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>'Response contract
200 · OK
dataarrayExpand fields
campaign_codestringcampaign_idstringcampaign_namestringcurrencystringdiscount_typestringdiscount_valuestringfirst_purchase_onlybooleanidstringstatusstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.