latestOpenAPI 3.1.12026-08-108026304.2 KB

7b222e8ec91c

Products

List products

Returns a paginated list of products

get/v1/products

Query parameters

limitstring

The number of items to retrieve

event_series_idstring

A string representing the event series ID

status'ON_SALE' | 'HIDDEN' | 'SOLD_OUT'

A string representing the add-on status

created_atinteger

Unix timestamp filter that returns items with matched created_at value.

created_at.gtinteger

Unix timestamp filter that returns items with created_at greater than given value.

created_at.gteinteger

Unix timestamp filter that returns items with created_at greater than or equal given value.

created_at.ltinteger

Unix timestamp filter that returns items with created_at less than given value.

created_at.lteinteger

Unix timestamp filter that returns items with created_at less than or equal given value.

updated_atinteger

Unix timestamp filter that returns items with matched updated_at value.

updated_at.gtinteger

Unix timestamp filter that returns items with updated_at greater than the given value.

updated_at.gteinteger

Unix timestamp filter that returns items with updated_at greater than or equal to the given value.

updated_at.ltinteger

Unix timestamp filter that returns items with updated_at less than given value.

updated_at.lteinteger

Unix timestamp filter that returns items with updated_at less than or equal given value.

Response

A successfully returned list of products

Example response

{
  "data": [
    {
      "object": "product",
      "id": "pr_1",
      "booking_fee": 100,
      "created_at": {
        "date": "2020-05-01",
        "formatted": "Fri 1 May 2020 10:30 PM",
        "iso": "2020-05-01T22:30:00+01:00",
        "time": "22:30",
        "timezone": "+01:00",
        "unix": 1588368600
      },
      "currency": "usd",
      "description": "This is a product",
      "event_series_ids": [
        "es_123",
        "es_234",
        "es_345"
      ],
      "instructions": "Buy this product at the venue",
      "issued_count": 0,
      "issue_ticket_voucher": "false",
      "voucher_id": null,
      "membership_type_id": null,
      "linked_to_all_event_series": "true",
      "name": "Test Product",
      "price": 956,
      "quantity": 10,
      "sell_in_store": "false",
      "status": "on_sale",
      "updated_at": {
        "date": "2020-05-01",
        "formatted": "Fri 1 May 2020 10:30 PM",
        "iso": "2020-05-01T22:30:00+01:00",
        "time": "22:30",
        "timezone": "+01:00",
        "unix": 1588368600
      }
    }
  ],
  "links": {
    "next": "/v1/products?starting_after=pr_120",
    "previous": "/v1/products?ending_before=pr_100"
  }
}