pretix MCP by usefulapi

List the organizer accounts this API token can access (slug, name, public URL). A team token sees its own organizer. GET /organizers/.

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One organizer account: slug, name, public URL. GET /organizers/{organizer}/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the events of an organizer (name, slug, dates, live/test mode, currency, location, whether it is an event series). Filter by search text, live state or date. GET /organizers/{organizer}/events/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "search": {
      "description": "Search text (event name or slug).",
      "type": "string",
      "maxLength": 200
    },
    "live": {
      "description": "Only events whose ticket shop is live (true) or not live (false).",
      "type": "boolean"
    },
    "is_public": {
      "description": "Only public (true) or non-public (false) events.",
      "type": "boolean"
    },
    "testmode": {
      "description": "Only events in test mode (true) or not (false).",
      "type": "boolean"
    },
    "has_subevents": {
      "description": "Only event series (true) or single events (false).",
      "type": "boolean"
    },
    "is_future": {
      "description": "Only events that are current or in the future (event series are never returned).",
      "type": "boolean"
    },
    "is_past": {
      "description": "Only events that are over (event series are never returned).",
      "type": "boolean"
    },
    "date_from_after": {
      "description": "Events starting after this date-time (ISO 8601 with timezone).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2}))?$"
    },
    "date_from_before": {
      "description": "Events starting before this date-time (ISO 8601 with timezone).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2}))?$"
    },
    "ordering": {
      "description": "Sort order (default slug).",
      "type": "string",
      "enum": [
        "date_from",
        "slug"
      ]
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One event in full: name, dates, location, currency, live/test mode, presale window, meta data, enabled plugins. GET /organizers/{organizer}/events/{event}/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    }
  },
  "required": [
    "event"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the dates (sub-events) of an event series, for one event or across all series of the organizer. Each has id, name, dates, location, presale window and price overrides. GET /organizers/{organizer}/events/{event}/subevents/ or /organizers/{organizer}/subevents/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "description": "Event slug. Omit to search across all events of the organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "search": {
      "description": "Search text.",
      "type": "string",
      "maxLength": 200
    },
    "active": {
      "description": "Only dates whose shop is active (true) or not (false).",
      "type": "boolean"
    },
    "is_public": {
      "description": "Only public (true) or non-public (false) dates.",
      "type": "boolean"
    },
    "is_future": {
      "description": "Only dates that are current or in the future.",
      "type": "boolean"
    },
    "is_past": {
      "description": "Only dates that are over.",
      "type": "boolean"
    },
    "date_from_after": {
      "description": "Dates starting after this date-time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2}))?$"
    },
    "date_from_before": {
      "description": "Dates starting before this date-time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2}))?$"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One date (sub-event) of an event series. GET /organizers/{organizer}/events/{event}/subevents/{id}/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "subevent_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Sub-event id."
    }
  },
  "required": [
    "event",
    "subevent_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the products (ticket types, merchandise) of an event with id, name, default price, tax, active flag, category and variations. GET /organizers/{organizer}/events/{event}/items/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "search": {
      "description": "Substring of the product name.",
      "type": "string",
      "maxLength": 200
    },
    "active": {
      "description": "Only active (true) or inactive (false) products.",
      "type": "boolean"
    },
    "admission": {
      "description": "Only admission products (true) or not (false).",
      "type": "boolean"
    },
    "category": {
      "description": "Category id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "event"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One product with its variations, add-ons and bundles. GET /organizers/{organizer}/events/{event}/items/{id}/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "item_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Product (item) id."
    }
  },
  "required": [
    "event",
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the quotas (capacity pools) of an event: size, the products they cover, closed state and, with with_availability, how many are still available. GET /organizers/{organizer}/events/{event}/quotas/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "subevent": {
      "description": "Only quotas of this event series date (sub-event id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "with_availability": {
      "description": "Add availability fields (available, available_number). Can be slow on big events.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "event"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

How much of a quota is left: available, available_number, total_size and what is using it (pending and paid orders, cart positions, blocking vouchers, waiting list). Values can lag slightly. GET /organizers/{organizer}/events/{event}/quotas/{id}/availability/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "quota_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Quota id."
    }
  },
  "required": [
    "event",
    "quota_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List orders of one event, or of all events of the organizer when no event is given: code, status, email, total, dates, positions, payments, invoice address. Contains customer personal data. Order secrets, order links and payment details are removed. GET /organizers/{organizer}/events/{event}/orders/ or /organizers/{organizer}/orders/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "description": "Event slug. Omit to search across all events of the organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "status": {
      "type": "string",
      "enum": [
        "n",
        "p",
        "e",
        "c"
      ],
      "description": "Order status: n = pending, p = paid, e = expired, c = canceled."
    },
    "search": {
      "description": "Search text over order code, names, emails and company names.",
      "type": "string",
      "maxLength": 200
    },
    "code": {
      "description": "Exact order code.",
      "type": "string",
      "maxLength": 32
    },
    "email": {
      "description": "Exact customer email.",
      "type": "string",
      "maxLength": 200
    },
    "item": {
      "description": "Only orders containing this product (item id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "subevent": {
      "description": "Only orders for this event series date (sub-event id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "testmode": {
      "description": "Only test-mode orders (true) or live orders (false).",
      "type": "boolean"
    },
    "require_approval": {
      "description": "Only orders waiting for approval (true) or not (false).",
      "type": "boolean"
    },
    "created_since": {
      "description": "Orders created at or after this date-time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2}))?$"
    },
    "created_before": {
      "description": "Orders created before this date-time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2}))?$"
    },
    "modified_since": {
      "description": "Orders modified at or after this date-time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2}))?$"
    },
    "ordering": {
      "description": "Sort order (default datetime).",
      "type": "string",
      "enum": [
        "datetime",
        "code",
        "last_modified",
        "status",
        "cancellation_date"
      ]
    },
    "include_canceled_positions": {
      "description": "Also return canceled positions inside orders.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One order by its code (e.g. ABC12): status, customer email and phone, total, positions (tickets), fees, payments, refunds as recorded, invoice address, check-in flags. Contains customer personal data. Secrets, order link and payment details are removed. GET /organizers/{organizer}/events/{event}/orders/{code}/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32,
      "description": "Order code, e.g. ABC12."
    },
    "include_canceled_positions": {
      "description": "Also return canceled positions.",
      "type": "boolean"
    }
  },
  "required": [
    "event",
    "code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the individual tickets (order positions) of one event, or of all events of the organizer when no event is given: attendee name and email, product, variation, price, order code, check-ins, answers. Contains attendee personal data. Ticket secrets are removed. GET /organizers/{organizer}/events/{event}/orderpositions/ or /organizers/{organizer}/orderpositions/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "description": "Event slug. Omit to search across all events of the organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "order": {
      "description": "Only tickets of this order code.",
      "type": "string",
      "maxLength": 32
    },
    "search": {
      "description": "Search text over attendee name, email and order code.",
      "type": "string",
      "maxLength": 200
    },
    "item": {
      "description": "Only this product (item id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "variation": {
      "description": "Only this variation id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "attendee_name": {
      "description": "Attendee name (exact match).",
      "type": "string",
      "maxLength": 200
    },
    "order__status": {
      "type": "string",
      "enum": [
        "n",
        "p",
        "e",
        "c"
      ],
      "description": "Order status: n = pending, p = paid, e = expired, c = canceled."
    },
    "has_checkin": {
      "description": "Only tickets that were checked in (true) or never (false).",
      "type": "boolean"
    },
    "subevent": {
      "description": "Only this event series date (sub-event id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "include_canceled_positions": {
      "description": "Also return canceled tickets.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the check-in lists of an event (id, name, the products they admit, event series date, rule settings). Use the list id for check-in status, attendee lists and check-in. GET /organizers/{organizer}/events/{event}/checkinlists/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "subevent": {
      "description": "Only lists of this event series date.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "event"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Live check-in numbers of a check-in list: how many tickets exist, how many are checked in, how many are inside now, broken down per product and variation. GET /organizers/{organizer}/events/{event}/checkinlists/{id}/status/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "checkin_list_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Check-in list id."
    }
  },
  "required": [
    "event",
    "checkin_list_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The attendee list of a check-in list: tickets with attendee name, product, order code, check-in history and whether the ticket needs attention. Contains attendee personal data. Ticket secrets are removed; check in by position id. GET /organizers/{organizer}/events/{event}/checkinlists/{id}/positions/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "checkin_list_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Check-in list id."
    },
    "search": {
      "description": "Search text over attendee name, email and order code.",
      "type": "string",
      "maxLength": 200
    },
    "item": {
      "description": "Only this product (item id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "attendee_name": {
      "description": "Attendee name (exact match).",
      "type": "string",
      "maxLength": 200
    },
    "order__status": {
      "type": "string",
      "enum": [
        "n",
        "p",
        "e",
        "c"
      ],
      "description": "Order status: n = pending, p = paid, e = expired, c = canceled."
    },
    "has_checkin": {
      "description": "Only tickets that were checked in (true) or not yet (false).",
      "type": "boolean"
    },
    "subevent": {
      "description": "Only this event series date.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "ignore_status": {
      "description": "Also list tickets of orders that are not paid or are canceled.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "event",
    "checkin_list_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the waiting list entries of an event: who waits for which product, since when, and whether a voucher was already sent. Contains personal data (name, email, phone). Read-only: no voucher is sent. GET /organizers/{organizer}/events/{event}/waitinglistentries/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "email": {
      "description": "Exact email address.",
      "type": "string",
      "maxLength": 200
    },
    "has_voucher": {
      "description": "Only entries that already got a voucher (true) or are still waiting (false).",
      "type": "boolean"
    },
    "item": {
      "description": "Only this product (item id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "variation": {
      "description": "Only this variation id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "subevent": {
      "description": "Only this event series date (sub-event id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "ordering": {
      "description": "Sort order (default created).",
      "type": "string",
      "enum": [
        "id",
        "created",
        "email",
        "item"
      ]
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-50 (default 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "event"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: check one ticket in (or out) on a check-in list. Records a real check-in in pretix and cannot be undone from here. Identify the ticket by position_id (from pretix_list_checkin_list_positions) or by ticket_secret (the scanned QR code content). pretix applies its own rules: the call is refused for unpaid, canceled, blocked, already-used or wrong-product tickets (the reason is returned), and it never forces a check-in. A required question that is unanswered comes back as incomplete with the question list; answer it with `answers`. One ticket per call. POST /organizers/{organizer}/events/{event}/checkinlists/{list}/positions/{id}/redeem/.

{
  "type": "object",
  "properties": {
    "organizer": {
      "description": "Organizer slug (see pretix_list_organizers). Optional when the login token sees exactly one organizer.",
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"
    },
    "event": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "Event slug (see pretix_list_events)."
    },
    "checkin_list_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Check-in list id."
    },
    "position_id": {
      "description": "Ticket (order position) id from pretix_list_checkin_list_positions. Give this or ticket_secret.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "ticket_secret": {
      "description": "The scanned ticket code (secret). Give this or position_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "type": {
      "description": "entry (default) or exit.",
      "type": "string",
      "enum": [
        "entry",
        "exit"
      ]
    },
    "answers": {
      "description": "Answers to required questions: { \"<question id>\": \"<answer>\" }. For choice questions use comma-separated option ids.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "nonce": {
      "description": "Idempotency key: a retry with the same nonce does not check in twice. Generated when omitted.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,64}$"
    }
  },
  "required": [
    "event",
    "checkin_list_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}