# Discount codes

> The discount codes your hosts share, what each one takes off, whether it is live, and whether it is synced to your store.

- Audience: API
- Page type: reference
- Updated: 2026-10-08
- Canonical URL: https://www.rendezvu.co/docs/api/discount-codes

A host discount code credits the host for any order it is used on, including orders with no click, such as a code read out on a podcast. Join codes to [orders](/docs/api/orders) by host to see what each code sells.

Needs the `codes:read` scope and a plan that includes Discount codes.

## List discount codes

`GET /api/brand/v1/codes`

The discount codes your hosts share, and whether each one is synced to your store.

Scope: `codes:read`. Plan feature: Discount codes. Paginated.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `page` | integer, optional, default `1` | The page to return, starting at 1. At most 10,000. |
| `per_page` | integer, optional, default `25` | Items per page, between 1 and 100. |
| `search` | string, optional | Match on the code or the host, 1 to 100 characters. |
| `include_inactive` | boolean, optional, default `false` | Include codes that are switched off. `true` or `false`. |

**Returns**

A page of codes. `data` is an array of objects with these attributes, and the body carries `pagination`.

| Attribute | Type | Description |
| --- | --- | --- |
| `id` | string | The code id. |
| `code` | string | What shoppers type at checkout. |
| `discount_type` | enum, nullable | `percent` or `amount`. |
| `discount_value` | number, nullable | The discount: 15 means 15% or 15 in your currency, by `discount_type`. |
| `active` | boolean | Shoppers can use it. |
| `synced_to_store` | boolean | The code exists as a discount in your store. |
| `host` | object | The host the code credits. |
| `host.id` | string | The host’s Rendezvu user id (UUID). |
| `host.username` | string, nullable | The host’s handle, as in rendezvu.co/username. |
| `host.first_name` | string, nullable | First name. |
| `host.last_name` | string, nullable | Last name. |
| `created_at` | timestamp | When the code was created. |
| `updated_at` | timestamp | When it last changed. |

**Example request**

```bash
curl 'https://api.rendezvu.co/api/brand/v1/codes?per_page=1' \
  -H "Authorization: Bearer $RENDEZVU_BRAND_API_KEY"
```

**Example response**

```json
{
  "success": true,
  "data": [
    {
      "id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
      "code": "JORDAN15",
      "discount_type": "percent",
      "discount_value": 15,
      "active": true,
      "synced_to_store": true,
      "host": {
        "id": "6f1c2a9e-3b4d-4e1f-9a8b-2c7d5e6f7a81",
        "username": "jordanalpine",
        "first_name": "Jordan",
        "last_name": "Reyes"
      },
      "created_at": "2026-05-11T12:00:00.000Z",
      "updated_at": "2026-05-11T12:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total_items": 22,
    "total_pages": 22,
    "has_next": true,
    "has_prev": false
  },
  "_timing": {
    "duration_ms": 42
  }
}
```

## Related

- [Orders](https://www.rendezvu.co/docs/api/orders.md): Every order Rendezvu attributed to one of your hosts, across your store and every connected network, with the host's commission on each.

---

Source: https://www.rendezvu.co/docs/api/discount-codes (Rendezvu docs, Markdown view). Every page: https://www.rendezvu.co/llms.txt