EventsHow it worksI'm an organizer

API and AI agents

Let your AI agent create your events, sessions and ticket types on ticketick, or query our catalogue of concerts and festivals in Switzerland.

MCP server

Connect Claude, ChatGPT, Cursor or any MCP-compatible agent: it creates and publishes your events in plain language.

REST API

JSON, one key per organizer, OpenAPI 3.1 specification. The same operations as the MCP server.

Public catalogue

Search events on sale, no key needed: dates, venues, prices, availability and booking links.

Get started in three steps

  1. 1In the ticketick admin, page “API & AI agents”, create a key. Tick “Can publish” only if the agent should put events online itself.
  2. 2Add the MCP server to your agent with the key in the Authorization header.
  3. 3Ask, for instance: “Create the Christmas concert on 5 December at 8 pm at the Temple in Rougemont, 300 seats, CHF 45 full price and CHF 20 students.”

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_…"
      }
    }
  }
}

Rules

  • An event created by an agent is a draft that you review before publishing, unless the key may publish.
  • A key acts only for its organizer. You can revoke it at any time.
  • Nothing that has sold tickets can be deleted through the API, and a session with sales keeps its date and venue.
  • Swiss local time, prices in Swiss francs, texts in French, English, German and Italian.

Available tools

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/eventsno key

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}no key

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

For developers and language models

ticketick

You choose what we share with third parties. Cart and checkout work either way. Learn more