Create watchlist item

curl --request POST \
  --url https://api.eventory.ai/watchlist \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "website": "ticketmaster",
  "event": "0200642CF18CAA24",
  "region": "US",
  "seat_quantity": 2,
  "max_price_filter": 250
}
'

import requests

url = "https://api.eventory.ai/watchlist"

payload = {
    "website": "ticketmaster",
    "event": "0200642CF18CAA24",
    "region": "US",
    "seat_quantity": 2,
    "max_price_filter": 250
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    website: 'ticketmaster',
    event: '0200642CF18CAA24',
    region: 'US',
    seat_quantity: 2,
    max_price_filter: 250
  })
};

fetch('https://api.eventory.ai/watchlist', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "item": {
    "id": 123,
    "client_id": 42,
    "website": "ticketmaster",
    "event": "0200642CF18CAA24",
    "region": "US",
    "min_price_filter": null,
    "max_price_filter": 250,
    "min_avg_price_threshold": null,
    "max_avg_price_threshold": null,
    "stock_threshold_filter": 1,
    "stock_threshold_filter_max": null,
    "min_stock_increase_filter": 4,
    "min_stock_decrease_filter": null,
    "seat_quantity": 2,
    "priority": 0,
    "section": null,
    "keywords": null,
    "date_filter": null,
    "row_filter": null,
    "change_type": "stock_increase",
    "standard_tickets": true,
    "resale_tickets": false,
    "general_admission_tickets": false,
    "platinum_tickets": false,
    "vip_tickets": false,
    "no_restricted_view": false,
    "no_accessibility": false,
    "no_presale": false,
    "auto_add_to_watchlist": false,
    "task_active": true,
    "muted_until": null,
    "notes": null,
    "tm_did": null,
    "roles_json": null,
    "webhook_setting_id": null,
    "role_id": null,
    "website_id": null,
    "created_at": "2026-06-18T09:20:00.123456",
    "updated_at": "2026-06-18T09:20:00.123456",
    "deleted": false
  },
  "items": [
    {
      "id": 123,
      "client_id": 42,
      "website": "ticketmaster",
      "event": "0200642CF18CAA24",
      "region": "US",
      "min_price_filter": null,
      "max_price_filter": 250,
      "min_avg_price_threshold": null,
      "max_avg_price_threshold": null,
      "stock_threshold_filter": 1,
      "stock_threshold_filter_max": null,
      "min_stock_increase_filter": 4,
      "min_stock_decrease_filter": null,
      "seat_quantity": 2,
      "priority": 0,
      "section": null,
      "keywords": null,
      "date_filter": null,
      "row_filter": null,
      "change_type": "stock_increase",
      "standard_tickets": true,
      "resale_tickets": false,
      "general_admission_tickets": false,
      "platinum_tickets": false,
      "vip_tickets": false,
      "no_restricted_view": false,
      "no_accessibility": false,
      "no_presale": false,
      "auto_add_to_watchlist": false,
      "task_active": true,
      "muted_until": null,
      "notes": null,
      "tm_did": null,
      "roles_json": null,
      "webhook_setting_id": null,
      "role_id": null,
      "website_id": null,
      "created_at": "2026-06-18T09:20:00.123456",
      "updated_at": "2026-06-18T09:20:00.123456",
      "deleted": false
    }
  ],
  "createdIds": [
    123
  ],
  "ignored_fields": [
    "platinum_tickets",
    "row_filter"
  ],
  "warning": "Not supported on this website/region and reset: platinum_tickets, row_filter"
}

Watchlist

Create watchlist item

Creates a watchlist item. website, event, and region are required; every other field is optional and takes the server default when omitted. Sending an explicit null stores NULL, except on boolean fields and priority, where it is ignored.

Keep the returned id: you need it to read, update, or delete the item. The Notifications API picks up new items within 60 seconds.

event may carry several ids separated by commas, which creates one item per id. Validation is all-or-nothing: if any one id fails the format check for that website and region, the whole request is rejected and nothing is created.

Active items count toward your plan’s limit of active events. A request that would go over it is rejected with 403 (Event limit reached: …), and nothing is created.

Unknown keys are rejected with 400, not ignored. The read-only fields returned by GET (id, client_id, created_at, updated_at, deleted, website_id) are accepted and ignored.

A filter that the target website / region does not support is dropped and listed in ignored_fields — the request still succeeds. See Watchlist platforms.

Cost: free.

POST

watchlist

Create watchlist item

curl --request POST \
  --url https://api.eventory.ai/watchlist \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "website": "ticketmaster",
  "event": "0200642CF18CAA24",
  "region": "US",
  "seat_quantity": 2,
  "max_price_filter": 250
}
'

import requests

url = "https://api.eventory.ai/watchlist"

payload = {
    "website": "ticketmaster",
    "event": "0200642CF18CAA24",
    "region": "US",
    "seat_quantity": 2,
    "max_price_filter": 250
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    website: 'ticketmaster',
    event: '0200642CF18CAA24',
    region: 'US',
    seat_quantity: 2,
    max_price_filter: 250
  })
};

fetch('https://api.eventory.ai/watchlist', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "item": {
    "id": 123,
    "client_id": 42,
    "website": "ticketmaster",
    "event": "0200642CF18CAA24",
    "region": "US",
    "min_price_filter": null,
    "max_price_filter": 250,
    "min_avg_price_threshold": null,
    "max_avg_price_threshold": null,
    "stock_threshold_filter": 1,
    "stock_threshold_filter_max": null,
    "min_stock_increase_filter": 4,
    "min_stock_decrease_filter": null,
    "seat_quantity": 2,
    "priority": 0,
    "section": null,
    "keywords": null,
    "date_filter": null,
    "row_filter": null,
    "change_type": "stock_increase",
    "standard_tickets": true,
    "resale_tickets": false,
    "general_admission_tickets": false,
    "platinum_tickets": false,
    "vip_tickets": false,
    "no_restricted_view": false,
    "no_accessibility": false,
    "no_presale": false,
    "auto_add_to_watchlist": false,
    "task_active": true,
    "muted_until": null,
    "notes": null,
    "tm_did": null,
    "roles_json": null,
    "webhook_setting_id": null,
    "role_id": null,
    "website_id": null,
    "created_at": "2026-06-18T09:20:00.123456",
    "updated_at": "2026-06-18T09:20:00.123456",
    "deleted": false
  },
  "items": [
    {
      "id": 123,
      "client_id": 42,
      "website": "ticketmaster",
      "event": "0200642CF18CAA24",
      "region": "US",
      "min_price_filter": null,
      "max_price_filter": 250,
      "min_avg_price_threshold": null,
      "max_avg_price_threshold": null,
      "stock_threshold_filter": 1,
      "stock_threshold_filter_max": null,
      "min_stock_increase_filter": 4,
      "min_stock_decrease_filter": null,
      "seat_quantity": 2,
      "priority": 0,
      "section": null,
      "keywords": null,
      "date_filter": null,
      "row_filter": null,
      "change_type": "stock_increase",
      "standard_tickets": true,
      "resale_tickets": false,
      "general_admission_tickets": false,
      "platinum_tickets": false,
      "vip_tickets": false,
      "no_restricted_view": false,
      "no_accessibility": false,
      "no_presale": false,
      "auto_add_to_watchlist": false,
      "task_active": true,
      "muted_until": null,
      "notes": null,
      "tm_did": null,
      "roles_json": null,
      "webhook_setting_id": null,
      "role_id": null,
      "website_id": null,
      "created_at": "2026-06-18T09:20:00.123456",
      "updated_at": "2026-06-18T09:20:00.123456",
      "deleted": false
    }
  ],
  "createdIds": [
    123
  ],
  "ignored_fields": [
    "platinum_tickets",
    "row_filter"
  ],
  "warning": "Not supported on this website/region and reset: platinum_tickets, row_filter"
}

Authorizations

apikey

string

header

required

Your Eventory API key. Sent as the apikey request header.

Body

application/json

Optional filters and options. Omit a field to keep the server default. Boolean fields and priority are never null; sending null for one is ignored.

website

string

required

Platform to monitor, e.g. ticketmaster. An unknown value is rejected with 400 (Unknown website: "<website>". …). For the platforms with a known id format, event is checked against that platform's (and often that region's) format. Some platforms are available on request: until one is enabled for your account, using it returns 403 (Website "<website>" is not available on this account). See Watchlist platforms for the recognised keys, the retired aliases, and the discovery monitors.

Example:

"ticketmaster"

event

string

required

Event identifier on that platform — a bare id or a full event URL depending on the platform. On create, several ids may be sent comma-separated to make one item each. For a discovery monitor this is the artist or venue URL rather than an event id.

Example:

"0200642CF18CAA24"

region

string

required

Region or market, e.g. US.

Example:

"US"

min_price_filter

number | null

Ignore tickets priced below this.

max_price_filter

number | null

Ignore tickets priced above this.

min_avg_price_threshold

number | null

max_avg_price_threshold

number | null

stock_threshold_filter

integer | null

Minimum available stock to notify on.

stock_threshold_filter_max

integer | null

Maximum available stock to notify on.

min_stock_increase_filter

integer | null

Only notify when the stock increase is at least this many tickets. Must be a positive integer; null turns the filter off. 0 or a negative value is rejected with 400.

Example:

4

min_stock_decrease_filter

integer | null

Only notify when the stock decrease is at least this many tickets. Must be a positive integer; null turns the filter off. 0 or a negative value is rejected with 400.

Example:

4

vip_tickets

boolean

Include VIP tickets.

seat_quantity

integer | null

Number of contiguous seats wanted.

priority

integer | null

section

string | null

Restrict to a section name.

keywords

string | null

date_filter

string | null

row_filter

string | null

change_type

enum<string> | null

default:stock_increase

Which change triggers a notification. The stream enforces this server-side. Any value outside this list is rejected with 400.

Available options:

stock_increase,

stock_decrease,

price_decrease,

price_increase,

null

standard_tickets

boolean

resale_tickets

boolean

general_admission_tickets

boolean

platinum_tickets

boolean

no_restricted_view

boolean

no_accessibility

boolean

no_presale

boolean

auto_add_to_watchlist

boolean

task_active

boolean

Whether monitoring for this item is active.

muted_until

string<date-time> | null

Suppress notifications until this time.

notes

string | null

tm_did

string | null

Ticketmaster device id.

roles_json

Pass-through JSON; treat as opaque.

webhook_setting_id

integer | null

role_id

integer | null

Response

Item created. item is the first created item and items carries all of them — the two differ only when event held several comma-separated ids.

item

object

required

Optional filters and options. Omit a field to keep the server default. Boolean fields and priority are never null; sending null for one is ignored.

Show child attributes

Example:

{
  "id": 123,
  "client_id": 42,
  "website": "ticketmaster",
  "event": "0200642CF18CAA24",
  "region": "US",
  "min_price_filter": null,
  "max_price_filter": 250,
  "min_avg_price_threshold": null,
  "max_avg_price_threshold": null,
  "stock_threshold_filter": 1,
  "stock_threshold_filter_max": null,
  "min_stock_increase_filter": 4,
  "min_stock_decrease_filter": null,
  "seat_quantity": 2,
  "priority": 0,
  "section": null,
  "keywords": null,
  "date_filter": null,
  "row_filter": null,
  "change_type": "stock_increase",
  "standard_tickets": true,
  "resale_tickets": false,
  "general_admission_tickets": false,
  "platinum_tickets": false,
  "vip_tickets": false,
  "no_restricted_view": false,
  "no_accessibility": false,
  "no_presale": false,
  "auto_add_to_watchlist": false,
  "task_active": true,
  "muted_until": null,
  "notes": null,
  "tm_did": null,
  "roles_json": null,
  "webhook_setting_id": null,
  "role_id": null,
  "website_id": null,
  "created_at": "2026-06-18T09:20:00.123456",
  "updated_at": "2026-06-18T09:20:00.123456",
  "deleted": false
}

items

object[]

required

Every item created by this request — more than one when event held several comma-separated ids.

Show child attributes

createdIds

integer[]

required

The ids of the created items, in the same order as items.

Example:

[123]

ignored_fields

string[]

Filters that were reset because the target website / region does not support them. Only seat_quantity, row_filter, tm_did, platinum_tickets and vip_tickets are checked. The request still succeeds; the stored item has those filters switched off: null, or true for platinum_tickets and vip_tickets. Absent when nothing was reset.

Example:

["platinum_tickets", "row_filter"]

warning

string

Human-readable summary of ignored_fields. Present only when ignored_fields is.

Example:

"Not supported on this website/region and reset: platinum_tickets, row_filter"

Overview

Market Data

Live Availability

Watchlist

Account

Create watchlist item

Authorizations

Body

Response