---
title: "List offerings"
method: GET
path: "/offerings"
tags: ["Offerings"]
---

# List offerings

`GET /offerings`

Returns regular offerings only. Experiment-variant offerings (owned by the experiments service) are excluded.

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

A paginated list of offerings.

- V4OfferingList
  - `object` 'list', required
  - `url` string, required
  - `data` V4Offering[], required
    - `object` 'offering', required
    - `id` string, required
    - `url` string, required
    - `tag` integer, nullable, required — Offering role within the project. `1` = main offering (`TAG_MAIN`) — exactly one offering per project has tag=1 at any time; promote via `POST /v4/offerings/{offering_id}/set-main`. `0` = regular offering that was demoted from main. `null` = regular offering that has never been tagged. Treat `0` and `null` as equivalent on read. The Offerings endpoints filter out experiment-variant offerings, but legacy rows could carry historical values other than `0`, `1`, or `null`, so the response field is intentionally not enum-restricted. Write schemas restrict accepted values server-side.
    - `product_ids` string[], required — Product UIDs that belong to this offering, in display order.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable

## Other responses

- `400` — Invalid request parameters.
- `401` — Missing or invalid authentication token.
- `500` — Internal error

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)