---
title: "List products"
method: GET
path: "/v1/products"
tags: ["Products"]
---

# List products

`GET /v1/products`

Returns a paginated list of products

## Query parameters

- `limit` string
- `event_series_id` string
- `status` 'ON_SALE' | 'HIDDEN' | 'SOLD_OUT'
- `created_at` integer
- `created_at.gt` integer
- `created_at.gte` integer
- `created_at.lt` integer
- `created_at.lte` integer
- `updated_at` integer
- `updated_at.gt` integer
- `updated_at.gte` integer
- `updated_at.lt` integer
- `updated_at.lte` integer

## Response `200`

A successfully returned list of products

- object
  - `data` Product[]
    - `object` string
    - `id` string
    - `booking_fee` integer, nullable — Optional booking fee in cents which is charged per product to the customer and the funds are paid to you. We would recommend charging no more than 10% of the product price.
    - `created_at` object, nullable — Date and time when the product was created
      - `date` string — ISO-8601 date for the created at date
      - `formatted` string — A formatted date string for the create at date
      - `iso` string — ISO-8601 date and time for the created at date
      - `time` string — Time of the end of the created at date
      - `timezone` string — Timezone offset for the created at date
      - `unix` integer — Unix timestamp for for the created at date
    - `currency` 'gbp' | 'usd' | 'eur' | 'sgd' | 'aud' | 'brl' | 'cad' | 'czk' | 'dkk' | 'hkd' | 'huf' | 'ils' | 'jpy' | 'myr' | 'mxn' | 'nok' | 'nzd' | 'php' | 'pln' | 'rub' | 'sek' | 'chf' | 'twd' | 'thb' | 'try', nullable — Information about the currency the product is configured to use
    - `description` string, nullable — Description of the product
    - `event_series_ids` string[], nullable — List of associated event series IDs
    - `image` string, nullable — Image associated with the product
    - `instructions` string, nullable — Instructions on how to use the product
    - `issued_count` integer — Number of sold products
    - `issue_ticket_voucher` string, nullable — A boolean value indicating whether a QR code is to be issued for the product
    - `linked_to_all_event_series` string, nullable — A 'true' or 'false' value to determine if the product is linked to all the event series
    - `membership_type_id` string, nullable — The ID of the membership type associated with the product
    - `name` string — Name of the product
    - `price` integer — Price in cents. Could be null.
    - `quantity` integer, nullable — Number available for purchase for all event occurrences
    - `quantity_per_event_occurrence` integer, nullable — Number available for purchase per event occurrence
    - `sell_in_store` string — A boolean value indicating whether product is being sold in store
    - `status` 'on_sale' | 'hidden' | 'sold_out', nullable — Status of the product
    - `voucher_id` string, nullable — The ID of the voucher of type gift card associated with the product
    - `updated_at` object, nullable
      - `date` string — ISO-8601 date for the updated timestamp of the product
      - `formatted` string — A formatted date string for the updated timestamp of the product
      - `iso` string — ISO-8601 date and time for the updated timestamp of the product
      - `time` string — Time of the updated timestamp of the product
      - `timezone` string — Timezone offset for the updated timestamp of the product
      - `unix` integer — Unix timestamp for when the product was updated
  - `links` object
    - `next` string, nullable
    - `previous` string, nullable

## Other responses

- `default` — Error schema

---

[API](https://skmtc.net/tickettailor/apis/ticket-tailor-api.md) · [All operations](https://skmtc.net/tickettailor/apis/ticket-tailor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tickettailor/ticket-tailor-api/revisions/7b222e8ec91c/schema)