# The List Access

> Nederlandse community voor clubnachten en dancefestivals, met een redactionele agenda, geselecteerde locaties, ticketaanbiedingen en eventpromotie. De site en de openbare content zijn hoofdzakelijk Nederlandstalig (nl-NL). Hieronder staat eerst de Nederlandse broninformatie, gevolgd door dezelfde informatie in het Engels.

Laatst inhoudelijk bijgewerkt / Documentation updated: 9 oktober 2026 / 9 October 2026. Dit is de datum van deze uitleg, niet de controledatum van alle events. / This dates the documentation, not every event observation.

## Nederlands — openbare bronnen
- [Events komende 30 dagen — JSON](https://thelistaccess.nl/feeds/events.json) en [RSS](https://thelistaccess.nl/feeds/events.rss): vandaag plus 29 dagen, alle resultaten zonder paginering.
- [Beschikbare guestlists — JSON](https://thelistaccess.nl/feeds/guestlists.json) en [RSS](https://thelistaccess.nl/feeds/guestlists.rss): alle komende events met een laatst gecontroleerde groepslink; geen bevestigde toegang.
- [Event highlights](https://thelistaccess.nl/highlights): eventcovers met links naar Instagram en beschikbare eventdetails; geen automatisch gesynchroniseerde stories.
- [Instagram-kanaal](https://www.instagram.com/channel/_FUEYbktsd9RrNfO/): eventnieuws, guestlists en aankondigingen op Instagram.
- [Homepage](https://thelistaccess.nl/): guestlists, tickets en WhatsApp-community.
- [Guestlists](https://thelistaccess.nl/guestlists): eventgroepen, Instagram-promo’s en voorwaarden; deelname is geen bevestigde plek.
- [Hoe het werkt](https://thelistaccess.nl/hoe-het-werkt): de stappen van eventkeuze tot bevestiging.
- [Agenda](https://thelistaccess.nl/events): komende clubnachten, dancefestivals en events overdag; filter op datum, stad, organisator en guestlists. Eventpagina’s verwijzen naar hun bronnen.
- Organisator-, stads- en maandpagina’s zijn bereikbaar via de agenda en sitemap: `/events/organisator/{slug}`, `/events/stad/{slug}` en `/events/maand/{YYYY-MM}`. Volg bestaande links; verzin geen slugs. Organisatoren omvatten bestaande partners en nieuwe merken, zoals Club Roto, Overbruggen, LAB54, ADATP en Wavy Events. Een organisatorvermelding betekent niet dat er een samenwerking of guestlistactie met The List bestaat.
- [Ticketaanbiedingen](https://thelistaccess.nl/tickets): actuele prijzen via The List en bekende servicekosten.
- [Clubs en locaties](https://thelistaccess.nl/locaties): geselecteerde locaties met adressen en officiële agenda’s.
- [Documentatie event- en locatie-API](https://thelistaccess.nl/events/data): openbare JSON om alleen te lezen, met filters en paginering.
- [OpenAPI-specificatie](https://thelistaccess.nl/openapi.json): machineleesbare beschrijving van de API’s.
- [Eventgegevens als JSON](https://thelistaccess.nl/api/events?limit=100): volg de volledige URL in `next` totdat de waarde `null` is; het eerste antwoord bevat niet alle resultaten.
- [Locatiegegevens als JSON](https://thelistaccess.nl/api/locaties): locatieoverzicht en komende events.
- [Sitemap](https://thelistaccess.nl/sitemap.xml): canonieke openbare pagina’s.
- [Linkpagina](https://thelistaccess.nl/linktree): community, eventgroepen, tickets en sociale links.
- [Veelgestelde vragen](https://thelistaccess.nl/faq): voorwaarden voor toegang en promotie.
- [Event aanmelden](https://thelistaccess.nl/event-aanmelden): samenwerkingsaanvragen van organisatoren; aanmelden publiceert geen event.

## Nederlands — uitleg van de gegevens
Gebruik `url` uit ieder record om naar de event- of locatiepagina van The List te verwijzen. `sourceUrl` en `agendaUrl` verwijzen naar externe officiële bronnen. `checkedAt` is het tijdstip van de laatste broncontrole; het garandeert niet dat de ticketvoorraad of toegangsvoorwaarden daarna ongewijzigd zijn gebleven. `modifiedAt` en `pageModifiedAt` beschrijven inhoudelijke wijzigingen. Ontbrekende feiten blijven onbekend. Een groepslink of `guestlistAvailable` bevestigt geen persoonlijke toegang. Raadpleeg de officiële organisator voor de actuele voorwaarden. Openbare leesantwoorden mogen 30 seconden worden hergebruikt; de onderliggende openbare bronlezingen kunnen daarnaast nog 30 seconden worden gecachet.

De linkpagina bewaart bij uitval van de updater de laatst gecontroleerde kopie en toont het werkelijke controletijdstip. Ook de openbare eventpagina’s en event-API gebruiken de laatst gecontroleerde groepslinks; deze verdwijnen niet automatisch na twaalf uur. Een oudere kopie is geen nieuwe controle en bevestigt niet dat een groepslink nog werkt. Bronfouten kunnen volledige dekking verhinderen. Bezoekersmetingen en particuliere aanvragen van organisatoren zijn geen openbare content-API’s.

## Nederlands — zoeken, organisatoren en dekking
`GET /api/events` ondersteunt uitsluitend `q`, `city`, `genre`, `from`, `to`, `guestlist`, `location`, `page` en `limit`. `q` doorzoekt naam, organisator, locatie, stad, genre, line-up en zoekaliassen; dit is geen exacte organisatorfilter. Gebruik bijvoorbeeld https://thelistaccess.nl/api/events?q=Club%20Roto&limit=100. De agenda heeft wel een aparte organisatorfilter; de API heeft geen `organizer`-parameter of aparte organisator-API. Het veld `organizer` is tekst en kan meerdere organisatoren bevatten. Citeer de organisatorpagina via de link op de eventpagina; als de organisator niet afzonderlijk bevestigd is, kan de site een eventbron of locatie tonen. Een locatie is niet automatisch de organisator.

`from` en `to` zijn inclusieve datums in YYYY-MM-DD. Zonder `from` begint de selectie vandaag in Europe/Amsterdam. Afgeronde en geannuleerde events ontbreken in deze API, ook als een ouder datumbereik wordt opgegeven. Lopende meerdaagse events blijven zichtbaar als hun einddatum in het bereik valt. Datums en tijden kunnen over middernacht lopen; gebruik bevestigde `startDateTime`, `endDateTime` en `endDate` waar aanwezig. Verzin geen eindtijd of tijdzone voor buitenlandse events.

De agenda is een selectie, geen volledig overzicht van Nederland of iedere organisator. Een leeg resultaat betekent alleen dat binnen deze selectie en filters geen passend event staat. De agenda is hoofdzakelijk Nederlands, met soms events buiten Nederland. Een organiserend merk, concept, stagehosting en locatie zijn verschillende rollen; leid relaties niet af uit uitsluitend een artiestnaam of locatie.

## Nederlands — tickets, guestlists en bronvermelding
Gebruik `slug` om hetzelfde event in de openbare gegevens te herkennen en citeer de canonieke eventpagina met `url`. De eventpagina’s kunnen MusicEvent-gegevens bevatten; dat garandeert geen opname in Google-eventresultaten of antwoorden van AI-systemen.

`ticketUrl` is de aanbevolen ticket- of bronlink van het record. `sourceUrl` blijft de bron voor eventinformatie; deze links kunnen verschillen. Bewaar volledige ticketlinks inclusief queryparameters: die kunnen een The List-aanbieding of specifiek event selecteren. Deel een guestlistlink alleen als die in het actuele openbare antwoord staat.

`ticketDeal` bevat een The List-aanbieding, met prijs, bekende servicekosten, valuta, reviewdatum en link. `regularTicket` bevat reguliere tickets zonder The List-korting, met `url`, `reviewedOn`, eventdatum, locatie en `phases`. Elke fase bevat `name`, `price`, `serviceFee` en `conditions`; tel prijs en servicekosten op voor het totaal en vermeld toegangstijden en fasevoorwaarden. `reviewedOn` is een leesbare historische datum, geen garantie van actuele voorraad. Ontbrekende servicekosten zijn onbekend, niet nul. `ticketOffer` kan een bevestigde totaalprijs bevatten. Neem valuta en eventueel expliciete beschikbaarheid over; verzin geen voorraadstatus.

`status=tickets` betekent dat het record een ticketroute heeft, niet dat er nu gegarandeerd tickets beschikbaar zijn. `sold-out` en `tba` zijn de laatst opgeslagen status. Bron- en reviewdatums blijven leidend. Geen vermelde prijs betekent onbekend, niet gratis. Een reguliere ticketprijs is geen korting. Ticketfases kunnen wijzigen of uitverkopen.

`guestlist=1` filtert op beschikbare laatst gecontroleerde eventgroeplinks. `guestlistAvailable` en `guestlistUrl` bevestigen geen persoonlijke gastenlijstplek, vrije toegang, samenwerking met iedere vermelde organisator of actuele ticketvoorraad. Voorwaarden, promorondes, minimumleeftijd en bevestiging volgen uit de eventpagina en de organisator. Gebruik geen algemene vaste volgerseis voor ieder event en leid een guestlist niet af uit alleen een agenda- of organisatorvermelding.

`address.sourceUrl`, `performerSource` en `detailsSource` onderbouwen specifieke aanvullingen. Ontbrekende prijs, tijd, adres, leeftijd, line-up of broncontrole blijft onbekend. `checkedAt` is een waarneming; `modifiedAt` en `pageModifiedAt` zijn wijzigingsdatums. Verwar deze niet met verkoopstart, eventdatum of publicatiedatum. De locaties-API geeft een compact eventoverzicht; gebruik de volledige event-API of eventpagina voor prijzen, guestlists en alle details.

## Nederlands — API-gebruik en actualiteit
De event-API geeft `schemaVersion`, `documentation`, `filters`, `total`, `page`, `limit`, `pages`, `next`, `previous` en `events`. Standaard zijn er 30 resultaten per pagina, maximaal 100; haal alle `next`-pagina’s op tot `null`. `total` geldt voor de filters, niet voor het hele festival- of organisatoraanbod. Er is geen snapshotsleutel: gegevens kunnen tussen aanvragen veranderen; ontdubbel op `slug` en vermeld het raadpleegmoment.

`GET /api/locaties` ondersteunt uitsluitend `city` en `id` en geeft `total` en `locations`, zonder paginering. Gebruik een bestaand locatie-ID als `location` in de event-API. Onbekende of herhaalde parameters, ongeldige datums, te lange waarden en ongeldige pagina’s geven 400; niet-ondersteunde HTTP-methoden geven 405. Publieke GET-antwoorden zijn zonder sleutel beschikbaar, ondersteunen CORS en ETag/If-None-Match met 304 en mogen 30 seconden worden gecachet. Dit is cacheduur, geen belofte dat alle externe bronnen iedere 30 seconden opnieuw worden gecontroleerd.

De ruwe leesfeeds https://thelistaccess.nl/api/calendar en https://thelistaccess.nl/api/access-feed tonen opgeslagen brongegevens en broncontroles zonder HTTP-cache. Ze vervangen de verrijkte event-API niet. Een succesvolle feedcontrole bewijst niet dat ieder event of iedere bron volledig is bijgewerkt. Bij bronuitval kan een oudere kopie behouden blijven; behoud de echte controledatum. Privégegevens, formulieren, bezoekersmetingen en schrijf-/synchronisatiehandelingen vallen buiten deze openbare leesdocumentatie.

## English — public sources
- [Events next 30 days — JSON](https://thelistaccess.nl/feeds/events.json) and [RSS](https://thelistaccess.nl/feeds/events.rss): today plus 29 days, all results without pagination.
- [Available guestlist groups — JSON](https://thelistaccess.nl/feeds/guestlists.json) and [RSS](https://thelistaccess.nl/feeds/guestlists.rss): all upcoming events with a last-verified group link; not confirmed admission.
- [Event highlights](https://thelistaccess.nl/highlights): event covers linking to Instagram and available event details; not an automatically synchronized story feed.
- [Instagram channel](https://www.instagram.com/channel/_FUEYbktsd9RrNfO/): event news, guestlists and announcements on Instagram.
- [Homepage](https://thelistaccess.nl/): guestlists, tickets and WhatsApp community.
- [Guestlists](https://thelistaccess.nl/guestlists): event groups, Instagram promotion and eligibility; membership does not confirm admission.
- [How it works](https://thelistaccess.nl/hoe-het-werkt): steps from choosing an event to confirmation.
- [Calendar](https://thelistaccess.nl/events): upcoming club nights, dance festivals and daytime events; date, city, organizer and guestlist filters.
- Organizer, city and month pages are linked from the calendar and sitemap: `/events/organisator/{slug}`, `/events/stad/{slug}` and `/events/maand/{YYYY-MM}`. Follow existing links rather than inventing slugs. An organizer listing does not establish a partnership or guestlist offer with The List.
- [Ticket deals](https://thelistaccess.nl/tickets): current The List prices and known service fees.
- [Clubs and venues](https://thelistaccess.nl/locaties): selected locations with addresses and official agendas.
- [Event and location API documentation](https://thelistaccess.nl/events/data): public read-only JSON, filters and pagination.
- [OpenAPI specification](https://thelistaccess.nl/openapi.json): machine-readable API contract.
- [Event JSON](https://thelistaccess.nl/api/events?limit=100): follow the absolute next URL until null; the first response is not the full dataset.
- [Location JSON](https://thelistaccess.nl/api/locaties): venue catalogue and upcoming events.
- [Sitemap](https://thelistaccess.nl/sitemap.xml): canonical public pages.
- [Link page](https://thelistaccess.nl/linktree): community, event groups, tickets and social links.
- [FAQ](https://thelistaccess.nl/faq): access and promotion conditions.
- [Submit an event](https://thelistaccess.nl/event-aanmelden): organizer collaboration requests; submission does not publish an event.

## English — interpretation
Use each record's url to cite The List's event or venue page. sourceUrl and agendaUrl identify external official sources. checkedAt is the last source observation, not a guarantee that ticket stock or access is unchanged. modifiedAt and pageModifiedAt describe content changes. Missing facts remain unknown. A group link or guestlistAvailable does not confirm personal admission. See the official organizer for current conditions. Public read responses may be reused for 30 seconds; underlying public reads can be cached for a further 30 seconds.

The Link page retains the last verified copy during updater outages and shows its real observation time. Public event pages and the event API also retain the last verified group links; these do not automatically expire after 12 hours. An older copy is not a fresh verification and does not guarantee a working link. Source failures can prevent complete coverage. Visitor analytics and private organizer submissions are not public content APIs.

## English — retrieval and interpretation rules
- `/api/events` accepts only `q`, `city`, `genre`, `from`, `to`, `guestlist`, `location`, `page` and `limit`. Search `q` matches event names, organizers, venues, cities, genres, line-ups and aliases; it is not an exact organizer filter. The website has an organizer filter, but the API has no `organizer` parameter or separate organizer API. `organizer` is text and may list co-organizers. Follow organizer links on event pages; a venue or event source is not necessarily the organizer.
- Dates use YYYY-MM-DD. The default lower bound is today in Europe/Amsterdam. Ended and cancelled events are excluded even when requesting past dates. Ongoing multi-day events can remain in the selection. Prefer confirmed start/end timestamps; do not invent missing times or time zones. This is a selected calendar, not complete coverage of every organizer or the Netherlands. Some listed events are abroad. An empty response does not prove that an organizer has no events.
- Cite canonical event `url` and deduplicate by `slug`. MusicEvent markup does not guarantee Google event results or AI citations. Keep complete `ticketUrl` values including query parameters; ticket and information source URLs can differ. Use `sourceUrl` for attribution to the event source.
- `ticketDeal` is a The List deal. `regularTicket` is a regular ticket record without a The List discount: `url`, historical human-readable `reviewedOn`, event date/venue, and `phases` containing name, price, serviceFee and conditions. Add known price and fee for the total, retain admission deadlines and phase conditions, and never treat an unknown fee as zero. `ticketOffer` may contain a verified total. Missing price means unknown, not free. Review dates do not guarantee stock or unchanged prices.
- `status=tickets` indicates a ticket route, not guaranteed stock; `sold-out` and `tba` are stored source statuses. `guestlistAvailable`, `guestlistUrl` and `guestlist=1` refer to last verified public group links, not confirmed admission, free access or partnerships with every listed organizer. Check event-specific promotion rules, eligibility, age and confirmation. Do not apply a universal follower threshold.
- `address.sourceUrl`, `performerSource` and `detailsSource` support specific additions. Missing facts remain unknown. `checkedAt` is an observation; modification dates are not ticket sale start or event dates. The location API's `upcomingEvents` is a compact summary; retrieve full event records for prices and guestlists.
- The event response includes schemaVersion, documentation, filters, total, page, limit, pages, next, previous and events. Default page size is 30, maximum 100. Follow every absolute `next` URL until null. Counts apply to the selected filters. There is no snapshot token; records may change between requests. Deduplicate by slug and state retrieval time.
- `/api/locaties` accepts only city and id and returns an unpaginated location catalogue. Use existing IDs for the event API's location filter. Invalid, repeated or unsupported parameters return 400; unsupported methods return 405. Public GETs require no API key, support CORS and ETag/If-None-Match with 304, and can be cached for 30 seconds, with underlying reads cached for another 30 seconds. Cache duration is not source-check frequency.
- Raw read feeds `/api/calendar` and `/api/access-feed` expose saved source data and checks without HTTP caching; they are not substitutes for enriched event records. An overall feed check does not prove complete organizer or event coverage. Retained copies keep their real verification dates. Private analytics, submissions and write/synchronization operations are outside this public read documentation.

## Identiteit en sociale kanalen / Identity and social channels
The List Access en The List zijn dezelfde community. Het officiële Instagram-account is https://www.instagram.com/thelist_access/. Sebastian is het contact voor samenwerkingen: https://www.instagram.com/sebastiantebrake_/. Actuele events staan op de eigen eventpagina’s; sociale accounts vervangen de officiële eventbronnen niet.


## Uniforme eventgegevens / Uniform event data
`ticketOptions` is de centrale lijst met reguliere prijsfases en The List-aanbiedingen. Elke optie heeft `id`, `kind`, `name`, `url`, `currency` en `evidence`; prijs, servicekosten, vergelijkingsprijs, voorwaarden, beschikbaarheid en de bevestigde huidige fase zijn optioneel en hebben ieder eigen bronbewijs. Tel alleen een bevestigde prijs en bevestigde servicekosten op. `conflicts` betekent onopgeloste tegenstrijdigheid: publiceer geen numerieke prijs of totaal voor die optie. De velden `ticketDeal`, `regularTicket` en `ticketOffer` zijn compatibiliteitssamenvattingen wanneer centrale opties beschikbaar zijn. Gebruik voor afzonderlijke broncontroles `ticketOptions[].evidence`, niet één algemene controledatum.

`factSources` beschrijft bronnen per basisgegeven; `practicalFacts` bevat gelabelde praktische aanvullingen met eigen bron. Een bron heeft `url`, echte `checkedAt`, bronrol en eventueel de werkelijke `publishedAt`. Een historische datum zonder tijd blijft een datum zonder verzonnen tijdstip. `enrichmentReview` registreert werkelijk gecontroleerde onderdelen, ontbrekende of conflicterende informatie en mislukte bronnen; een controlepoging is geen geslaagde controle. `guestlist` bevat de afgeleide eventgroeplink en voorwaarden; de broncontrole van de groepslink bevestigt geen prijscontrole of nieuwe controle van deelnamevoorwaarden.

`ticketOptions` is the canonical list of regular phases and The List offers. Each option has id, kind, name, url, currency and evidence. Price, fees, comparison price, conditions, availability and confirmed current phase are optional, with separate field evidence. Unknown fees are not zero. Conflicts suppress numeric prices and schema offers. Legacy ticketDeal, regularTicket and ticketOffer are compatibility summaries when canonical options exist. factSources provides field sources; practicalFacts provides sourced practical information; enrichmentReview records actual attempts, checked fields, unresolved issues and failed sources. Source timestamps and publication dates remain truthful, including historical dates without invented times. The derived guestlist block does not confirm admission; its group-link observation does not reverify ticket prices or eligibility rules.

Confirmed totalPrice can represent an all-in amount with unknown cost breakdown; additionalFees records mandatory variable/order-level costs and blocks an incomplete calculated total. Individually verified duplicate editions share one canonical record and older detail URLs retain canonical links.

Ticket action URLs omit inherited source UTM/click/referral/coupon parameters. Only the three verified Overbruggen offers and Club Roto partner route currently carry The List codes. Technical shop/event selectors are preserved and do not imply an offer; source evidence retains its original URL and observation date.