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

# List offers and coupons

> Filter partner catalog campaigns

Campaigns (offers and coupons) live at `GET /api/partner/campaigns`. There is no separate `/offers` path.

## Offers

```bash theme={null}
curl -X GET "https://api.lomadee.com.br/api/partner/campaigns?types=Offer&offerType=Url&page=1&limit=10" \
  -H "x-api-key: $LOMADEE_PARTNER_API_KEY"
```

`offerType` accepts `EOffer` values (for example `Url` and `Spreadsheet`).

## Generic coupons

```bash theme={null}
curl -X GET "https://api.lomadee.com.br/api/partner/campaigns?types=GenericCoupon" \
  -H "x-api-key: $LOMADEE_PARTNER_API_KEY"
```

The payload may include `url` and `code` (public prefix). `PersonalCoupon` codes are not returned.

## Useful filters

| Parameter                            | Use                              |
| ------------------------------------ | -------------------------------- |
| `organizationId` / `organizationIds` | Brand(s)                         |
| `name`                               | Name search                      |
| `status`                             | `onTime`, `expired`, `scheduled` |
| `categories`                         | CSV                              |
| `isHighlight`                        | Highlights                       |
| `startAt` / `endAt`                  | Created-at range                 |

Pagination: `page` (default 1), `limit` (default 10, max 20).

Detail: `GET /api/partner/campaigns/{campaignId}`.