> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get coupon

> Get the details of a specific coupon.

**app\_id** `string` *required*

Your store ID in Jelou Shop.

**coupon\_id** `string` *required*

Coupon ID.

```bash cURL theme={null}
curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/coupons/{coupon_id}?include=branches" \
  -H "x-api-key: YOUR_API_KEY"
```

```json 200 Success theme={null}
{
  "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
        }
      }
    ]
  }
}
```

> [!NOTE]
>
> 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**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.