VeranstaltungenSo funktioniert'sIch bin Veranstalter

API und KI-Agenten

Lassen Sie Ihren KI-Agenten Veranstaltungen, Vorstellungen und Tarife auf ticketick anlegen, oder durchsuchen Sie unseren Katalog von Konzerten und Festivals in der Schweiz.

MCP-Server

Verbinden Sie Claude, ChatGPT, Cursor oder jeden MCP-fähigen Agenten: Er legt Ihre Veranstaltungen in natürlicher Sprache an und veröffentlicht sie.

REST-API

JSON, ein Schlüssel pro Veranstalter, OpenAPI-3.1-Spezifikation. Dieselben Operationen wie der MCP-Server.

Öffentlicher Katalog

Suche nach Veranstaltungen im Verkauf, ohne Schlüssel: Daten, Orte, Preise, Verfügbarkeit und Buchungslinks.

In drei Schritten starten

  1. 1Erstellen Sie im ticketick-Admin, Seite «API & KI-Agenten», einen Schlüssel. Aktivieren Sie «Darf veröffentlichen» nur, wenn der Agent selbst veröffentlichen soll.
  2. 2Fügen Sie den MCP-Server mit dem Schlüssel im Authorization-Header zu Ihrem Agenten hinzu.
  3. 3Bitten Sie ihn zum Beispiel: «Lege das Weihnachtskonzert am 5. Dezember um 20 Uhr im Temple in Rougemont an, 300 Plätze, CHF 45 Vollpreis und CHF 20 für Studierende.»

MCP

https://ticketick.ch/api/mcp
claude mcp add --transport http ticketick https://ticketick.ch/api/mcp \
  --header "Authorization: Bearer tt_…"
{
  "mcpServers": {
    "ticketick": {
      "type": "http",
      "url": "https://ticketick.ch/api/mcp",
      "headers": {
        "Authorization": "Bearer tt_…"
      }
    }
  }
}

Regeln

  • Eine vom Agenten angelegte Veranstaltung ist ein Entwurf, den Sie vor der Veröffentlichung prüfen, ausser der Schlüssel darf veröffentlichen.
  • Ein Schlüssel handelt nur für seinen Veranstalter. Sie können ihn jederzeit widerrufen.
  • Nichts mit verkauften Tickets kann über die API gelöscht werden, und eine Vorstellung mit Verkäufen behält Datum und Ort.
  • Schweizer Ortszeit, Preise in Franken, Texte auf Französisch, Englisch, Deutsch und Italienisch.

Verfügbare Werkzeuge

whoamiGET /api/v1/me

Organizer account and permissions of the API key. Call it first: it states the rules (drafts, publish permission, time zone, currency).

list_eventsGET /api/v1/events

Events of the organizer (drafts included), newest first, with status, next session and tickets sold.

get_eventGET /api/v1/events/{eventId}

Full event: texts, payment, sessions, venues, ticket types, sales counters and links (public page, admin).

create_eventPOST /api/v1/events

Create an event with, in the same call, its sessions (dates, venue, capacity) and ticket types (prices in CHF). It is a draft unless publish is true and the key may publish. Times without offset are Swiss local time. Texts are per language ({ fr, en, de, it }); give at least one. Returns the event with its admin link for review.

update_eventPATCH /api/v1/events/{eventId}

Change texts, categories, visibility, payment methods, contact or cover image. Only the given fields change. A key without publish permission may only change drafts.

delete_eventDELETE /api/v1/events/{eventId}

Delete a draft event without sales, with its sessions and ticket types.

publish_eventPOST /api/v1/events/{eventId}/publish

Put the event online (status PUBLISHED). Needs a key with publish permission, an upcoming session and, for online sale, a ticket type.

unpublish_eventPOST /api/v1/events/{eventId}/unpublish

Turn an event without sales back into a draft. Needs a key with publish permission.

add_sessionPOST /api/v1/events/{eventId}/sessions

Add a dated session (performance) to an event, with its venue, capacity and ticket types.

update_sessionPATCH /api/v1/sessions/{sessionId}

Change a session's times, label, venue or capacity. A session with sold tickets keeps its date and venue (use « Programme modifié » in the admin). null clears an optional field.

delete_sessionDELETE /api/v1/sessions/{sessionId}

Delete a session without sales.

add_ticket_typePOST /api/v1/sessions/{sessionId}/ticket-types

Add a ticket type (price in CHF, quantity) to a session.

update_ticket_typePATCH /api/v1/ticket-types/{ticketTypeId}

Change a ticket type's name, price, quantity (not below sold), limit per order or sales window.

delete_ticket_typeDELETE /api/v1/ticket-types/{ticketTypeId}

Delete a ticket type without sales.

list_venuesGET /api/v1/venues

Venues already used by the organizer, or search all ticketick venues by name or city with q. Reuse a venueId rather than creating a duplicate venue.

list_categoriesGET /api/v1/categories

Event categories (slug and names) to use in create_event.

search_eventsGET /api/v1/public/eventsohne Schlüssel

Public catalogue of ticketick.ch: upcoming concerts, festivals, theatre and shows in Switzerland, with dates, venues, prices, availability and booking links. No API key needed.

get_public_eventGET /api/v1/public/events/{slug}ohne Schlüssel

Public details of an event on ticketick.ch: full description, upcoming sessions, ticket prices, availability and booking link. No API key needed.

Für Entwickler und Sprachmodelle

ticketick

Sie entscheiden, was wir mit Dritten teilen. Warenkorb und Bezahlung funktionieren in jedem Fall. Mehr erfahren