---
title: "List global coupons (catalogue API)"
method: POST
path: "/api/v1/catalog/coupons"
tags: ["Global catalogue"]
---

# List global coupons (catalogue API)

`POST /api/v1/catalog/coupons`

## Request

- Base URL: `https://api.feedico.io`
- URL: `https://api.feedico.io/api/v1/catalog/coupons`
- Auth: HTTP bearer

Coded coupons deduped by brand + code; no offerUrl. See openapi-customer.yaml for full examples.

## Request body

- CustomerDataListRequest
  - `page` integer: 1-based page index.
  - `pageSize` integer: Items per page (max 200).
  - `provider` string, nullable: Filter by integration id (matches values in response `availableProviders`).
  - `firmName` string, nullable: Substring filter on merchant display name (networks); on coupons - linked programme display name, title, or external merchant key.

## Response `200`

Global coupon page

- CatalogCouponListResponse
  - `ok` boolean, required
  - `recordCount` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `availableProviders` string[], required
  - `coupons` CatalogCouponRow[], required
    - `id` string
    - `brandName` string
    - `provider` string
    - `code` string
    - `title` string, nullable
    - `description` string, nullable
    - `startsAt` string, nullable
    - `endsAt` string, nullable
    - `merchantWebsiteUrl` string, nullable
    - `goUrl` string, nullable: Tracked Feedico link (null when the store is not in the managed catalogue). Join the Partner Program to earn the commission yourself.
    - `fetchedAt` string, nullable

## Other responses

- `401`: Missing or invalid bearer token
- `429`: Monthly API quota exceeded

---

[API](https://skmtc.dev/feedico/apis/feedico-api.md) · [All operations](https://skmtc.dev/feedico/apis/feedico-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feedico/apis/feedico-api/revisions/c290c4636799?raw)