curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/coupons/{coupon_id}?include=branches" \
-H "x-api-key: YOUR_API_KEY"
{
"data": {
"id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"code": "CENTRO20",
"name": "Downtown 20%",
"description": "20% off at the Downtown branch",
"discount_type": "percentage",
"discount_value": "20.000000",
"status": true,
"valid_from": null,
"valid_until": null,
"max_uses": null,
"once_per_client": false,
"applies_to_all_branches": false,
"state": "active",
"created_at": "2026-07-02T15:30:00.000000Z",
"updated_at": "2026-07-02T15:30:00.000000Z",
"branches": [
{
"id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"name": "Downtown Branch",
"code": "SUC-CENTRO",
"pivot": {
"coupon_id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"branch_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"max_uses": 50,
"status": true
}
}
]
}
}
Promotions
Get coupon
Get the details of a specific coupon.
GET
/
ecommerce
/
v2
/
apps
/
{app_id}
/
coupons
/
{coupon_id}
curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/coupons/{coupon_id}?include=branches" \
-H "x-api-key: YOUR_API_KEY"
{
"data": {
"id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"code": "CENTRO20",
"name": "Downtown 20%",
"description": "20% off at the Downtown branch",
"discount_type": "percentage",
"discount_value": "20.000000",
"status": true,
"valid_from": null,
"valid_until": null,
"max_uses": null,
"once_per_client": false,
"applies_to_all_branches": false,
"state": "active",
"created_at": "2026-07-02T15:30:00.000000Z",
"updated_at": "2026-07-02T15:30:00.000000Z",
"branches": [
{
"id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"name": "Downtown Branch",
"code": "SUC-CENTRO",
"pivot": {
"coupon_id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"branch_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"max_uses": 50,
"status": true
}
}
]
}
}
Your store ID in Jelou Shop.
Coupon ID.
curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/coupons/{coupon_id}?include=branches" \
-H "x-api-key: YOUR_API_KEY"
{
"data": {
"id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"code": "CENTRO20",
"name": "Downtown 20%",
"description": "20% off at the Downtown branch",
"discount_type": "percentage",
"discount_value": "20.000000",
"status": true,
"valid_from": null,
"valid_until": null,
"max_uses": null,
"once_per_client": false,
"applies_to_all_branches": false,
"state": "active",
"created_at": "2026-07-02T15:30:00.000000Z",
"updated_at": "2026-07-02T15:30:00.000000Z",
"branches": [
{
"id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"name": "Downtown Branch",
"code": "SUC-CENTRO",
"pivot": {
"coupon_id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
"branch_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"max_uses": 50,
"status": true
}
}
]
}
}
Branches only appear if you request the relation with
?include=branches. The pivot object contains the coupon’s max_uses and status for that branch.Was this page helpful?
⌘I