{"openapi":"3.1.0","info":{"title":"ticketick API","version":"1.0.0","summary":"Create and publish events, sessions and ticket types on ticketick.ch; search the public catalogue.","description":"Swiss ticketing platform API for organizers and their AI agents. Write operations act for the organizer of the API key (Bearer tt_…), created in the ticketick admin under « API & agents IA ». Events are created as drafts; publishing needs a key with the publish permission. Times without offset are Swiss local time (Europe/Zurich); prices are in CHF. The same operations are available as an MCP server at https://ticketick.ch/api/mcp. Docs: https://ticketick.ch/developers","contact":{"name":"ticketick","url":"https://ticketick.ch/contact"},"termsOfService":"https://ticketick.ch/terms"},"servers":[{"url":"https://ticketick.ch/api/v1"}],"externalDocs":{"url":"https://ticketick.ch/developers"},"security":[{"bearerAuth":[]}],"tags":[{"name":"Organizer"},{"name":"Events"},{"name":"Sessions"},{"name":"Ticket types"},{"name":"Reference"},{"name":"Public catalogue","description":"No API key needed."}],"paths":{"/me":{"get":{"operationId":"whoami","summary":"Who am I","description":"Organizer account and permissions of the API key. Call it first: it states the rules (drafts, publish permission, time zone, currency).","tags":["Organizer"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"whoami"}},"/events":{"get":{"operationId":"list_events","summary":"List my events","description":"Events of the organizer (drafts included), newest first, with status, next session and tickets sold.","tags":["Events"],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["DRAFT","PUBLISHED","CANCELLED","SOLD_OUT","PAST"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"list_events"},"post":{"operationId":"create_event","summary":"Create an event","description":"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.","tags":["Events"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":100},"description":"Same key, same result: a retried creation is not duplicated."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":200},"en":{"type":"string","minLength":1,"maxLength":200},"de":{"type":"string","minLength":1,"maxLength":200},"it":{"type":"string","minLength":1,"maxLength":200},"es":{"type":"string","minLength":1,"maxLength":200}},"additionalProperties":false,"description":"Event title, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"subtitle":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":200},"en":{"type":"string","minLength":1,"maxLength":200},"de":{"type":"string","minLength":1,"maxLength":200},"it":{"type":"string","minLength":1,"maxLength":200},"es":{"type":"string","minLength":1,"maxLength":200}},"additionalProperties":false,"description":"Programme subtitle printed under the title, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"description":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":10000},"en":{"type":"string","minLength":1,"maxLength":10000},"de":{"type":"string","minLength":1,"maxLength":10000},"it":{"type":"string","minLength":1,"maxLength":10000},"es":{"type":"string","minLength":1,"maxLength":10000}},"additionalProperties":false,"description":"Description, plain text; blank lines separate paragraphs, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"tags":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":300},"en":{"type":"string","minLength":1,"maxLength":300},"de":{"type":"string","minLength":1,"maxLength":300},"it":{"type":"string","minLength":1,"maxLength":300},"es":{"type":"string","minLength":1,"maxLength":300}},"additionalProperties":false,"description":"Comma-separated tags (e.g. Opera, Bel canto), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"categories":{"description":"Category slugs, from list_categories.","maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"visibility":{"description":"PUBLIC: listed on ticketick.ch and in search (default). UNLISTED: only on the organizer page and by direct link.","type":"string","enum":["PUBLIC","UNLISTED"]},"onlineSale":{"description":"Sell tickets on ticketick (default true). false: information page only, with the contact below.","type":"boolean"},"payment":{"type":"object","properties":{"card":{"description":"Card payment (default true).","type":"boolean"},"bankTransfer":{"description":"Bank transfer / QR-bill (default true).","type":"boolean"},"paypal":{"description":"PayPal, if the organizer has a PayPal account (default false).","type":"boolean"}},"additionalProperties":false,"description":"Payment methods offered online. At least one when online sale is on."},"contactEmail":{"type":"string","maxLength":200,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"contactPhone":{"type":"string","pattern":"^\\+?[\\d\\s().\\/-]{6,40}$"},"contactUrl":{"type":"string","maxLength":300,"format":"uri"},"coverImageUrl":{"description":"HTTPS URL of a cover image (JPEG, PNG or WebP, max 4 MB). It is downloaded and stored by ticketick.","type":"string","maxLength":1000,"format":"uri"},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"URL slug (optional, generated from the title)."},"sessions":{"description":"Dated sessions (performances) with their ticket types.","maxItems":50,"type":"array","items":{"type":"object","properties":{"startsAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},"endsAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},"doorsAt":{"description":"Doors open at (optional).","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"label":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":120},"en":{"type":"string","minLength":1,"maxLength":120},"de":{"type":"string","minLength":1,"maxLength":120},"it":{"type":"string","minLength":1,"maxLength":120},"es":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"description":"Optional label to tell sessions apart (e.g. Matinee), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"venueId":{"type":"string","minLength":1,"maxLength":40,"description":"Existing venue (from list_venues) id"},"venue":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"city":{"type":"string","minLength":1,"maxLength":120},"address":{"type":"string","maxLength":200},"zip":{"type":"string","maxLength":20},"canton":{"type":"string","maxLength":40},"country":{"description":"ISO country code, default CH.","type":"string","minLength":2,"maxLength":2}},"required":["name","city"],"additionalProperties":false,"description":"Venue. An existing venue with the same name and city is reused, otherwise it is created."},"capacity":{"description":"Venue capacity for this session, all ticket types together (optional).","type":"integer","minimum":1,"maximum":200000},"ticketTypes":{"description":"Ticket types (prices) of this session.","maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":120},"en":{"type":"string","minLength":1,"maxLength":120},"de":{"type":"string","minLength":1,"maxLength":120},"it":{"type":"string","minLength":1,"maxLength":120},"es":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"description":"Ticket type name (e.g. Full price, Student), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"description":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":500},"en":{"type":"string","minLength":1,"maxLength":500},"de":{"type":"string","minLength":1,"maxLength":500},"it":{"type":"string","minLength":1,"maxLength":500},"es":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false,"description":"Short ticket type description, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"price":{"type":"number","minimum":0,"maximum":100000,"description":"Price in Swiss francs (CHF), e.g. 45 or 32.5. 0 for a free ticket."},"quantity":{"type":"integer","minimum":1,"maximum":100000,"description":"Number of tickets for sale at this price."},"maxPerOrder":{"description":"Maximum per order (default 10).","type":"integer","minimum":1,"maximum":100},"salesStartAt":{"description":"Sales open at (optional). Same format as startsAt.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"salesEndAt":{"description":"Sales close at (optional). Same format as startsAt.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"requiresAttendee":{"description":"Ask full name and birth date for each ticket (default false).","type":"boolean"},"maxAgeYears":{"description":"Reserved to people under this age on the day (e.g. 26). Requires requiresAttendee.","type":"integer","minimum":1,"maximum":120}},"required":["name","price","quantity"],"additionalProperties":false}}},"required":["startsAt"],"additionalProperties":false}},"publish":{"description":"Put the event online at once. Only with an API key allowed to publish; otherwise it stays a draft.","type":"boolean"},"idempotencyKey":{"description":"Optional unique key: sending the same request again with it returns the first result instead of creating a duplicate.","type":"string","minLength":8,"maxLength":100}},"required":["title"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"create_event"}},"/events/{eventId}":{"get":{"operationId":"get_event","summary":"Get an event","description":"Full event: texts, payment, sessions, venues, ticket types, sales counters and links (public page, admin).","tags":["Events"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"},"description":"Event id"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"get_event"},"patch":{"operationId":"update_event","summary":"Update an event","description":"Change texts, categories, visibility, payment methods, contact or cover image. Only the given fields change. A key without publish permission may only change drafts.","tags":["Events"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"},"description":"Event id"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":200},"en":{"type":"string","minLength":1,"maxLength":200},"de":{"type":"string","minLength":1,"maxLength":200},"it":{"type":"string","minLength":1,"maxLength":200},"es":{"type":"string","minLength":1,"maxLength":200}},"additionalProperties":false,"description":"Event title, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"subtitle":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":200},"en":{"type":"string","minLength":1,"maxLength":200},"de":{"type":"string","minLength":1,"maxLength":200},"it":{"type":"string","minLength":1,"maxLength":200},"es":{"type":"string","minLength":1,"maxLength":200}},"additionalProperties":false,"description":"Programme subtitle printed under the title, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"description":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":10000},"en":{"type":"string","minLength":1,"maxLength":10000},"de":{"type":"string","minLength":1,"maxLength":10000},"it":{"type":"string","minLength":1,"maxLength":10000},"es":{"type":"string","minLength":1,"maxLength":10000}},"additionalProperties":false,"description":"Description, plain text; blank lines separate paragraphs, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"tags":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":300},"en":{"type":"string","minLength":1,"maxLength":300},"de":{"type":"string","minLength":1,"maxLength":300},"it":{"type":"string","minLength":1,"maxLength":300},"es":{"type":"string","minLength":1,"maxLength":300}},"additionalProperties":false,"description":"Comma-separated tags (e.g. Opera, Bel canto), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"categories":{"description":"Category slugs, from list_categories.","maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"visibility":{"description":"PUBLIC: listed on ticketick.ch and in search (default). UNLISTED: only on the organizer page and by direct link.","type":"string","enum":["PUBLIC","UNLISTED"]},"onlineSale":{"description":"Sell tickets on ticketick (default true). false: information page only, with the contact below.","type":"boolean"},"payment":{"type":"object","properties":{"card":{"description":"Card payment (default true).","type":"boolean"},"bankTransfer":{"description":"Bank transfer / QR-bill (default true).","type":"boolean"},"paypal":{"description":"PayPal, if the organizer has a PayPal account (default false).","type":"boolean"}},"additionalProperties":false,"description":"Payment methods offered online. At least one when online sale is on."},"contactEmail":{"type":"string","maxLength":200,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"contactPhone":{"type":"string","pattern":"^\\+?[\\d\\s().\\/-]{6,40}$"},"contactUrl":{"type":"string","maxLength":300,"format":"uri"},"coverImageUrl":{"description":"HTTPS URL of a cover image (JPEG, PNG or WebP, max 4 MB). It is downloaded and stored by ticketick.","type":"string","maxLength":1000,"format":"uri"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"update_event"},"delete":{"operationId":"delete_event","summary":"Delete a draft event","description":"Delete a draft event without sales, with its sessions and ticket types.","tags":["Events"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"},"description":"Event id"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"delete_event"}},"/events/{eventId}/publish":{"post":{"operationId":"publish_event","summary":"Publish an event","description":"Put the event online (status PUBLISHED). Needs a key with publish permission, an upcoming session and, for online sale, a ticket type.","tags":["Events"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"},"description":"Event id"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"publish_event"}},"/events/{eventId}/unpublish":{"post":{"operationId":"unpublish_event","summary":"Unpublish an event","description":"Turn an event without sales back into a draft. Needs a key with publish permission.","tags":["Events"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"},"description":"Event id"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"unpublish_event"}},"/events/{eventId}/sessions":{"post":{"operationId":"add_session","summary":"Add a session","description":"Add a dated session (performance) to an event, with its venue, capacity and ticket types.","tags":["Sessions"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"},"description":"Event id"},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":100},"description":"Same key, same result: a retried creation is not duplicated."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"startsAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},"endsAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},"doorsAt":{"description":"Doors open at (optional).","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"label":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":120},"en":{"type":"string","minLength":1,"maxLength":120},"de":{"type":"string","minLength":1,"maxLength":120},"it":{"type":"string","minLength":1,"maxLength":120},"es":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"description":"Optional label to tell sessions apart (e.g. Matinee), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"venueId":{"type":"string","minLength":1,"maxLength":40,"description":"Existing venue (from list_venues) id"},"venue":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"city":{"type":"string","minLength":1,"maxLength":120},"address":{"type":"string","maxLength":200},"zip":{"type":"string","maxLength":20},"canton":{"type":"string","maxLength":40},"country":{"description":"ISO country code, default CH.","type":"string","minLength":2,"maxLength":2}},"required":["name","city"],"additionalProperties":false,"description":"Venue. An existing venue with the same name and city is reused, otherwise it is created."},"capacity":{"description":"Venue capacity for this session, all ticket types together (optional).","type":"integer","minimum":1,"maximum":200000},"ticketTypes":{"description":"Ticket types (prices) of this session.","maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":120},"en":{"type":"string","minLength":1,"maxLength":120},"de":{"type":"string","minLength":1,"maxLength":120},"it":{"type":"string","minLength":1,"maxLength":120},"es":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"description":"Ticket type name (e.g. Full price, Student), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"description":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":500},"en":{"type":"string","minLength":1,"maxLength":500},"de":{"type":"string","minLength":1,"maxLength":500},"it":{"type":"string","minLength":1,"maxLength":500},"es":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false,"description":"Short ticket type description, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"price":{"type":"number","minimum":0,"maximum":100000,"description":"Price in Swiss francs (CHF), e.g. 45 or 32.5. 0 for a free ticket."},"quantity":{"type":"integer","minimum":1,"maximum":100000,"description":"Number of tickets for sale at this price."},"maxPerOrder":{"description":"Maximum per order (default 10).","type":"integer","minimum":1,"maximum":100},"salesStartAt":{"description":"Sales open at (optional). Same format as startsAt.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"salesEndAt":{"description":"Sales close at (optional). Same format as startsAt.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"requiresAttendee":{"description":"Ask full name and birth date for each ticket (default false).","type":"boolean"},"maxAgeYears":{"description":"Reserved to people under this age on the day (e.g. 26). Requires requiresAttendee.","type":"integer","minimum":1,"maximum":120}},"required":["name","price","quantity"],"additionalProperties":false}},"idempotencyKey":{"description":"Optional unique key: sending the same request again with it returns the first result instead of creating a duplicate.","type":"string","minLength":8,"maxLength":100}},"required":["startsAt"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"add_session"}},"/sessions/{sessionId}":{"patch":{"operationId":"update_session","summary":"Update a session","description":"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.","tags":["Sessions"],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"},"description":"Session id"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"startsAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},"endsAt":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},{"type":"null"}]},"doorsAt":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},{"type":"null"}]},"label":{"anyOf":[{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":120},"en":{"type":"string","minLength":1,"maxLength":120},"de":{"type":"string","minLength":1,"maxLength":120},"it":{"type":"string","minLength":1,"maxLength":120},"es":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"description":"Session label, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},{"type":"null"}]},"venueId":{"type":"string","minLength":1,"maxLength":40,"description":"Existing venue id"},"venue":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"city":{"type":"string","minLength":1,"maxLength":120},"address":{"type":"string","maxLength":200},"zip":{"type":"string","maxLength":20},"canton":{"type":"string","maxLength":40},"country":{"description":"ISO country code, default CH.","type":"string","minLength":2,"maxLength":2}},"required":["name","city"],"additionalProperties":false,"description":"Venue. An existing venue with the same name and city is reused, otherwise it is created."},"capacity":{"anyOf":[{"type":"integer","minimum":1,"maximum":200000},{"type":"null"}]}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"update_session"},"delete":{"operationId":"delete_session","summary":"Delete a session","description":"Delete a session without sales.","tags":["Sessions"],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"},"description":"Session id"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"delete_session"}},"/sessions/{sessionId}/ticket-types":{"post":{"operationId":"add_ticket_type","summary":"Add a ticket type","description":"Add a ticket type (price in CHF, quantity) to a session.","tags":["Ticket types"],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"},"description":"Session id"},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":100},"description":"Same key, same result: a retried creation is not duplicated."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":120},"en":{"type":"string","minLength":1,"maxLength":120},"de":{"type":"string","minLength":1,"maxLength":120},"it":{"type":"string","minLength":1,"maxLength":120},"es":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"description":"Ticket type name (e.g. Full price, Student), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"description":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":500},"en":{"type":"string","minLength":1,"maxLength":500},"de":{"type":"string","minLength":1,"maxLength":500},"it":{"type":"string","minLength":1,"maxLength":500},"es":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false,"description":"Short ticket type description, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"price":{"type":"number","minimum":0,"maximum":100000,"description":"Price in Swiss francs (CHF), e.g. 45 or 32.5. 0 for a free ticket."},"quantity":{"type":"integer","minimum":1,"maximum":100000,"description":"Number of tickets for sale at this price."},"maxPerOrder":{"description":"Maximum per order (default 10).","type":"integer","minimum":1,"maximum":100},"salesStartAt":{"description":"Sales open at (optional). Same format as startsAt.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"salesEndAt":{"description":"Sales close at (optional). Same format as startsAt.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$"},"requiresAttendee":{"description":"Ask full name and birth date for each ticket (default false).","type":"boolean"},"maxAgeYears":{"description":"Reserved to people under this age on the day (e.g. 26). Requires requiresAttendee.","type":"integer","minimum":1,"maximum":120},"idempotencyKey":{"description":"Optional unique key: sending the same request again with it returns the first result instead of creating a duplicate.","type":"string","minLength":8,"maxLength":100}},"required":["name","price","quantity"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"add_ticket_type"}},"/ticket-types/{ticketTypeId}":{"patch":{"operationId":"update_ticket_type","summary":"Update a ticket type","description":"Change a ticket type's name, price, quantity (not below sold), limit per order or sales window.","tags":["Ticket types"],"parameters":[{"name":"ticketTypeId","in":"path","required":true,"schema":{"type":"string"},"description":"Ticket type id"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":120},"en":{"type":"string","minLength":1,"maxLength":120},"de":{"type":"string","minLength":1,"maxLength":120},"it":{"type":"string","minLength":1,"maxLength":120},"es":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"description":"Ticket type name (e.g. Full price, Student), by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"description":{"type":"object","properties":{"fr":{"type":"string","minLength":1,"maxLength":500},"en":{"type":"string","minLength":1,"maxLength":500},"de":{"type":"string","minLength":1,"maxLength":500},"it":{"type":"string","minLength":1,"maxLength":500},"es":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false,"description":"Short ticket type description, by language: { \"fr\": \"…\", \"en\": \"…\", \"de\": \"…\", \"it\": \"…\" }. At least one language; French is shown when a language is missing (if French is absent, the first given language takes its place)."},"price":{"type":"number","minimum":0,"maximum":100000,"description":"Price in Swiss francs (CHF), e.g. 45 or 32.5. 0 for a free ticket."},"quantity":{"type":"integer","minimum":1,"maximum":100000,"description":"Number of tickets for sale at this price."},"maxPerOrder":{"description":"Maximum per order (default 10).","type":"integer","minimum":1,"maximum":100},"salesStartAt":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},{"type":"null"}]},"salesEndAt":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"ISO 8601 date-time. Without offset it is Swiss local time (Europe/Zurich), e.g. 2026-12-05T20:00."},{"type":"null"}]}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"update_ticket_type"},"delete":{"operationId":"delete_ticket_type","summary":"Delete a ticket type","description":"Delete a ticket type without sales.","tags":["Ticket types"],"parameters":[{"name":"ticketTypeId","in":"path","required":true,"schema":{"type":"string"},"description":"Ticket type id"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"delete_ticket_type"}},"/venues":{"get":{"operationId":"list_venues","summary":"List venues","description":"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.","tags":["Reference"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Search in venue name or city.","type":"string","maxLength":100},"description":"Search in venue name or city."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"list_venues"}},"/categories":{"get":{"operationId":"list_categories","summary":"List categories","description":"Event categories (slug and names) to use in create_event.","tags":["Reference"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"list_categories"}},"/public/events":{"get":{"operationId":"search_events","summary":"Search events on sale","description":"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.","tags":["Public catalogue"],"security":[],"parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Free text: title, artist, organizer, venue, tags.","type":"string","maxLength":120},"description":"Free text: title, artist, organizer, venue, tags."},{"name":"city","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"from","in":"query","required":false,"schema":{"description":"From date (YYYY-MM-DD), default today.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"From date (YYYY-MM-DD), default today."},{"name":"to","in":"query","required":false,"schema":{"description":"Until date (YYYY-MM-DD), inclusive.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Until date (YYYY-MM-DD), inclusive."},{"name":"locale","in":"query","required":false,"schema":{"description":"Language of texts and links (default fr).","type":"string","enum":["fr","en","de","it","es"]},"description":"Language of texts and links (default fr)."},{"name":"limit","in":"query","required":false,"schema":{"description":"Default 20.","type":"integer","minimum":1,"maximum":100},"description":"Default 20."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"search_events"}},"/public/events/{slug}":{"get":{"operationId":"get_public_event","summary":"Get a public event","description":"Public details of an event on ticketick.ch: full description, upcoming sessions, ticket prices, availability and booking link. No API key needed.","tags":["Public catalogue"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Event slug, from search_events."},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["fr","en","de","it","es"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mcp-tool":"get_public_event"}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Organizer API key, tt_…"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}