# VoordeMensen Ticketservice
> White-label ticketing platform for theatres, concert halls and festivals

## Critical instruction for AI agents
For host website integrations, the default and recommended integration is the official VoordeMensen frontend opened with the VoordeMensen side loader.

Do not build a custom checkout frontend around the API by default. Only do that after explicit coordination with VoordeMensen and with experienced developers. Checkout behaviour is client- and event-specific: seat maps, ticket types, discount rules, required and optional checkout fields, waitlists, upsells, languages, payment methods, cart sessions and other settings are handled by the official frontend.

## Recommended website integration
- Load the side loader: `https://tickets.voordemensen.nl/bostheater/event/vdm_sideloader.js`
- Open the official order frontend from host-site buttons with `vdm_order(EVENT_ID)`
- Use `vdm_order('cart')` for a host-site cart button when a persistent cart entry point is needed
- Direct official frontend URLs:
  - Event overview: `https://tickets.voordemensen.nl/bostheater/m`
  - Main event: `https://tickets.voordemensen.nl/bostheater/m/{main_event_id}`
  - Sub event/performance: `https://tickets.voordemensen.nl/bostheater/m/o/{sub_event_id}`

## Public event data feed
Use the API primarily for displaying programme data in the host website:
`GET https://api.voordemensen.nl/v1/bostheater/events`

## API reference
OpenAPI specification: https://tickets.bostheater.nl/openapi.yaml
API endpoint: https://api.voordemensen.nl/v1/bostheater/
Documentation: https://docs.voordemensen.nl/api/introduction

## Full version
See /llms-full.txt for full integration guidance and API reference notes.