Billetto API-documentatie en webhooks-gids
Wat je kunt bouwen met de Billetto API
De Billetto API is een REST API die JSON teruggeeft. Je eigen code krijgt toegang tot dezelfde data waarop je ticketverkoop draait: evenementen, tickettypes, bestellingen, bezoekers, boekingsposten, boekingsvragen en doelgroepen. Webhooks sturen je wijzigingen zodra ze gebeuren, zodat je er niet om hoeft te vragen.
Teams gebruiken de API om kopers naar een CRM te synchroniseren, verkopen in een data warehouse te laden, evenementen op hun eigen website te tonen, leden aan presale-doelgroepen toe te voegen en uitbetalingen in hun financiële systeem af te stemmen. Deze pagina legt uit hoe de API is opgebouwd en hoe webhooks werken. Het volledige schema van elk endpoint vind je in de API-referentie.
Begin hier
- Startgids: inloggegevens aanmaken en je eerste aanroep doen
- API-referentie: alle endpoints, parameters en responsobjecten
- Webhook-referentie: de webhook-resource en de velden ervan
- Public Event Search: openbaar beschikbare evenementen op Billetto ophalen
Authenticeren met een API-sleutelpaar of OAuth 2.0
API-sleutelparen voor je eigen account
Gebruik een sleutelpaar wanneer je eigen systemen de API aanroepen namens je organisatoraccount. Maak het aan in Billetto onder Integrations → Developers → API - Key pairs, geef het een naam die het doel beschrijft (bijvoorbeeld "CRM-sync" of "Data warehouse") en stuur het bij elke aanroep mee in de header Api-Keypair.
- Maak per systeem een eigen sleutelpaar aan, zodat je er één kunt intrekken zonder de andere te raken
- Bewaar het secret op je server. Zet het nooit in een browser, een mobiele app of een openbare repository
- Trek een sleutelpaar direct in en vervang het als je vermoedt dat het is uitgelekt
OAuth 2.0 voor apps die andere organisatoren gebruiken
Gebruik OAuth wanneer je een product bouwt waarmee andere Billetto-organisatoren verbinding maken, zoals een marketingtool, een evenementenplatform of een dashboard voor bureaus. OAuth gebruikt de authorization code flow: de organisator logt in bij Billetto, keurt je app goed en jij krijgt een token voor zijn account. Je ziet nooit zijn wachtwoord, en hij kan je app op elk moment loskoppelen.
Beide methoden worden stap voor stap beschreven in de startgids.
- Evenementen
- Bestellingen en bezoekers
- Financiën en rapporten
- Audiences
- Webhooks
- Openbare evenementen
Evenementen en tickettypes
Haal de evenementen van je account op met datum, locatie, status en tickettypes.
GET /organiser/eventstoont je evenementen- Tickettypes, prijzen en beschikbaarheid per evenement
- Boekingsvragen die je kopers stelt bij het afrekenen
Typisch gebruik
Toon je komende evenementen met live beschikbaarheid op je eigen website of app en stuur kopers door naar de Billetto-checkout.
Bestellingen en bezoekers
Zie wie wat wanneer voor welk evenement heeft gekocht.
GET /organiser/orderstoont bestellingen voor al je evenementenGET /organiser/events/{event_id}/attendeestoont de bezoekers van een evenement- Resultaten komen per pagina: haal de volgende pagina op tot er geen meer komt
Typisch gebruik
Houd kopersgegevens in je CRM actueel of stuur bezoekerslijsten naar een toegangs- of accreditatiesysteem.
Boekingsposten en rapporten
Krijg de financiële details achter je ticketverkoop.
GET /organiser/ledger_entriestoont verkopen, terugbetalingen, kosten en uitbetalingen- Een BI-rapport per evenement met de belangrijkste verkoopcijfers
Typisch gebruik
Laad omzet in je boekhouding of data warehouse en stem die af met je uitbetalingen.
Doelgroepen en leden
Schrijf data terug naar Billetto in plaats van die alleen te lezen.
- Leden van doelgroepen aanmaken, bijwerken en verwijderen
- Volledige lijsten importeren en de importstatus volgen
- Een doelgroep en het aantal leden ophalen
Typisch gebruik
Synchroniseer leden, abonnees of partnerlijsten uit je CRM met Audiences voor presales en exclusieve aanbiedingen.
Webhook-abonnementen
Beheer webhooks met code in plaats van in de Billetto-interface.
POST /organiser/webhooksregistreert een endpoint-URL- Een bestaande webhook bijwerken of verwijderen
- Een nieuw ondertekeningssecret voor een webhook genereren
Typisch gebruik
Registreer webhooks automatisch wanneer een nieuwe klant of omgeving wordt ingericht, en vervang secrets volgens planning.
Public Event Search
Doorzoek evenementen die openbaar op Billetto staan, van alle organisatoren.
- Queryparameters om resultaten te filteren, beschreven in de referentie
- Elk resultaat linkt naar de evenementpagina en de checkout
Typisch gebruik
Media, stadsgidsen en partnerplatforms laten zo zien wat er te doen is, met tickets die via Billetto worden verkocht.
IN DE PRAKTIJK
De Billetto API en webhooks, stap voor stap
APIStap 1: toegang
Maak een sleutelpaar aan en doe je eerste aanroep
Open Integrations, ga naar het tabblad Developers en maak een sleutelpaar aan voor het systeem dat je koppelt. Kopieer het secret, voeg het toe aan je request-headers en roep een endpoint aan zoals /organiser/orders. Het antwoord is JSON dat je direct in je eigen datamodel kunt gebruiken.
- Eén sleutelpaar per integratie, vernoemd naar het systeem dat het gebruikt
- JSON-antwoorden voor evenementen, bestellingen, bezoekers en boekingsposten
- Trek een sleutelpaar op elk moment in zonder de andere te raken
Integrations
Example dataAPI - Key pairs
+ Create key pairAUDIENCESStap 2: naar Billetto schrijven
Voeg contacten via de API toe aan een doelgroep
De Audiences-endpoints zijn de belangrijkste manier om data naar Billetto te schrijven. Stuur contacten uit je CRM naar een doelgroep of importeer een hele lijst en controleer de status tot die klaar is. Daarna is de groep klaar voor uitnodigingen, presales en exclusieve aanbiedingen.
- Leden één voor één toevoegen, bijwerken en verwijderen
- Bulkimports met een status die je kunt opvragen
- Groepen verschijnen direct in Audiences
Audiences
Example dataVIP members 2026Synced via API
WEBHOOKSStap 3: Billetto-webhooks
Registreer een webhook en zie leveringen live
Voeg je endpoint-URL toe in het tabblad Developers, en Billetto genereert er een ondertekeningssecret voor. Vanaf dat moment wordt elke bestelling, terugbetaling, bezoekerswijziging of publicatie van een evenement als HTTP POST met een JSON-body naar je URL gestuurd.
- Instellen in de interface of via POST /organiser/webhooks
- Eén ondertekeningssecret per webhook, dat je opnieuw kunt genereren
- De webhooks-kaart toont de URL en API-versie van elke webhook
Integrations
Example dataWebhooks
Receive data based on specific webhook events
Recent deliveriesLive
Wat Billetto-webhooks zijn en wanneer je ze gebruikt
Een webhook is een URL op je server die Billetto aanroept wanneer er iets in je account verandert. In plaats van de API om de paar minuten te vragen naar nieuwe bestellingen, krijg je een aanroep op het moment dat een bestelling wordt aangemaakt, terugbetaald of gewijzigd.
Daarom zijn webhooks het juiste hulpmiddel wanneer timing telt: een bevestiging in je CRM binnen enkele seconden, een Slack-bericht wanneer een VIP-ticket wordt verkocht, of een toegangssysteem dat van een geannuleerd ticket moet weten voordat de deuren opengaan.
Webhooks of de API?
- Gebruik webhooks om te reageren op wijzigingen zodra ze gebeuren: nieuwe bestellingen, terugbetalingen, bezoekerswijzigingen en gepubliceerde evenementen
- Gebruik de API om historie te laden, een nachtelijke volledige synchronisatie te draaien of details op te halen die een webhook niet bevat
- Gebruik beide voor de meest betrouwbare oplossing: webhooks voor snelheid en een geplande API-synchronisatie die alles opvangt wat je hebt gemist
Zo wordt een Billetto-webhook afgeleverd
Van de verkoop van een ticket tot de verwerking in je systeem.Bouw een betrouwbare webhook-ontvanger
Beveiliging
- Controleer elke aanroep met het ondertekeningssecret van de webhook voordat je de inhoud vertrouwt. De webhook-referentie beschrijft hoe
- Accepteer alleen HTTPS en bewaar het secret in je serverconfiguratie, niet in je code
- Genereer een nieuw secret als het mogelijk is uitgelekt, en werk daarna je ontvanger bij
Betrouwbaarheid
- Antwoord snel. Geef een 2xx-status terug zodra de aanroep is gecontroleerd en doe het zware werk in een queue
- Vang duplicaten op. Sla verwerkte ID's op, zodat dezelfde bestelling nooit twee keer wordt aangemaakt
- Reken niet op de volgorde. Als die belangrijk is, haal dan de actuele status van de bestelling op via de API
- Stem regelmatig af. Een geplande API-synchronisatie vangt op wat je endpoint tijdens een storing heeft gemist
Billetto API-referentie
De API-referentie documenteert elk endpoint met parameters, voorbeeldaanroepen en responsobjecten. Gebruik die samen met deze gids wanneer je begint met programmeren: zoek hierboven de juiste resource en zoek daarna de exacte velden op in de referentie.
Webhook-referentie
De webhook-resource bevat de configuratie van een endpoint: de URL, de gebruikte API-versie en het ondertekeningssecret. We raden aan je eerste webhook in Billetto aan te maken onder Integrations → Developers en die via de API te beheren zodra je setup groeit.
Public Event Search API
De Public Event Search API levert evenementen die organisatoren openbaar op Billetto hebben gezet, van alle organisatoren. Hij is geschikt voor mediasites, stadsgidsen, toerismeorganisaties en partner-apps die willen laten zien wat er te doen is, waarbij elk resultaat linkt naar de Billetto-evenementpagina waar tickets worden gekocht.
Vragen over de Billetto API en webhooks
Technische vragen van developers die met de Billetto API werken. Staat je antwoord er niet bij? Praat met ons team.
Log in bij Billetto, open Integrations en ga naar het tabblad Developers. Onder API - Key pairs kun je een nieuw sleutelpaar aanmaken, zien van wie elk sleutelpaar is en sleutels intrekken die je niet meer gebruikt.
Een sleutelpaar geeft je eigen systemen toegang tot je eigen organisatoraccount. OAuth 2.0 is voor apps waarmee andere organisatoren hun Billetto-account koppelen, zodat je namens hen handelt zonder hun inloggegevens te kennen.
Webhooks dekken wijzigingen in bestellingen, bezoekers en evenementen, zoals nieuwe bestellingen, terugbetalingen, bezoekerswijzigingen en gepubliceerde evenementen. De webhook-referentie toont alle gebeurtenissen en hun inhoud.
Elke webhook heeft zijn eigen ondertekeningssecret. Controleer daarmee elke binnenkomende aanroep voordat je die verwerkt, en wijs aanroepen af die de controle niet doorstaan. Je kunt op elk moment een nieuw secret voor een webhook genereren.
Ja. Je kunt webhooks registreren, bijwerken en verwijderen via de webhook-endpoints, en een nieuw ondertekeningssecret genereren voor een bestaande webhook. De meeste teams beginnen in de interface en stappen over op de API wanneer ze meerdere omgevingen beheren.
429 betekent dat je te veel aanroepen doet. Wacht en probeer het opnieuw met een steeds langere pauze, en gebruik webhooks in plaats van vaak pollen om het aantal aanroepen laag te houden.
Ja. Gebruik de Public Event Search API voor evenementen die openbaar op Billetto staan, of het events-endpoint van de organisator voor je eigen evenementen. Kopers ronden hun aankoop af in de Billetto-checkout.
Ja. Google Analytics 4, de Meta Pixel, Zapier en je eigen betaalprovider kun je zonder code koppelen. Bij Billetto-integraties zie je wat je in een paar minuten kunt instellen.
Denmark