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

# Obtener cupón

> Obtén los detalles de un cupón específico.

<ParamField path="app_id" type="string" required>
  ID de tu tienda en Jelou Shop.
</ParamField>

<ParamField path="coupon_id" type="string" required>
  ID del cupón.
</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: TU_CLAVE_API"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": {
      "id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
      "code": "CENTRO20",
      "name": "Centro 20%",
      "description": "20% en la sucursal Centro",
      "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": "Sucursal Centro",
          "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>
  Las sucursales solo aparecen si pides la relación con `?include=branches`. El objeto `pivot` contiene el `max_uses` y `status` del cupón **para esa sucursal**.
</Note>