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

# Get coupon

> Retrieve a specific coupon by UUID code

## Endpoint

```
GET https://api.partnero.com/v1/coupons/{uuid_code}
```

## Path Parameters

| Parameter   | Type   | Required | Description               |
| ----------- | ------ | -------- | ------------------------- |
| `uuid_code` | string | Yes      | Coupon's unique UUID code |

## Request

```bash cURL theme={null}
curl --location 'https://api.partnero.com/v1/coupons/coupon_123' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "name": "PARTNERO25",
      "uuid_code": "coupon_123",
      "active": true,
      "coupon_discount_type": "percent",
      "coupon_discount_amount": 25,
      "coupon_duration_type": "months",
      "coupon_duration_value": 11,
      "redemption_specific_date_status": false,
      "redemption_specific_date_value": null,
      "redemption_times_status": true,
      "redemption_times_value": 24,
      "metadata": [],
      "created_at": "2025-05-07T17:43:26.000000Z",
      "updated_at": "2025-05-07T17:43:26.000000Z",
      "deleted_at": null
    },
    "status": 1
  }
  ```
</ResponseExample>

### Response Fields

| Field                          | Type    | Description                         |
| ------------------------------ | ------- | ----------------------------------- |
| `data.name`                    | string  | Customer-facing coupon name         |
| `data.uuid_code`               | string  | Unique coupon identifier            |
| `data.active`                  | boolean | Whether coupon is active            |
| `data.coupon_discount_type`    | string  | `percent` or `static`               |
| `data.coupon_discount_amount`  | number  | Discount amount or percentage       |
| `data.coupon_duration_type`    | string  | Duration type                       |
| `data.coupon_duration_value`   | integer | Duration value                      |
| `data.redemption_times_status` | boolean | Whether redemption limit is enabled |
| `data.redemption_times_value`  | integer | Max redemptions allowed             |