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

<ParamField path="app_id" type="string" required>
  Your store ID in Jelou Shop.
</ParamField>

<ParamField path="coupon_id" type="string" required>
  Coupon ID.
</ParamField>

<RequestExample>
  ```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"
  ```
</RequestExample>

<ResponseExample>
  ```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
          }
        }
      ]
    }
  }
  ```
</ResponseExample>

<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**.
</Note>