API et agents IA
Laissez votre agent IA créer vos spectacles, séances et tarifs sur ticketick, ou interrogez notre catalogue de concerts et festivals en Suisse.
Serveur MCP
Branchez Claude, ChatGPT, Cursor ou tout agent compatible MCP : il crée et publie vos événements en langage naturel.
API REST
JSON, clé par organisateur, spécification OpenAPI 3.1. Les mêmes opérations que le serveur MCP.
Catalogue public
Recherche des spectacles en vente, sans clé : dates, lieux, prix, places et liens de réservation.
Démarrer en trois étapes
- 1Dans l'admin ticketick, page « API & agents IA », créez une clé. Cochez « Peut publier » seulement si l'agent doit mettre en ligne lui-même.
- 2Ajoutez le serveur MCP à votre agent avec la clé dans l'en-tête Authorization.
- 3Demandez-lui par exemple : « Crée le concert de Noël le 5 décembre à 20 h au Temple de Rougemont, 300 places, 45 CHF plein tarif et 20 CHF étudiant. »
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_…"
}
}
}
}Les règles
- Un événement créé par un agent est un brouillon, que vous relisez avant de publier, sauf si la clé a le droit de publier.
- Une clé n'agit que pour son organisateur. Vous la révoquez à tout moment.
- Rien de ce qui a vendu des billets ne peut être supprimé par l'API, et une séance vendue garde sa date et son lieu.
- Heures en heure suisse, prix en francs suisses, textes en français, anglais, allemand et italien.
Outils disponibles
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/eventssans clé
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}sans clé
Public details of an event on ticketick.ch: full description, upcoming sessions, ticket prices, availability and booking link. No API key needed.