Aan de slag

Met de Avayo API haal je je eigen gegevens uit ons systeem: verkoopcijfers voor rapportage, en je evenementen, voorstellingen en producten voor beheer. Deze pagina is genoeg om binnen tien minuten je eerste aanroep te doen.

Je toegangstoken

Alles begint met een token. Dat maak je zelf aan in je backoffice, onder Instellingen > API-tokens. Geef elke koppeling een eigen token met een herkenbare omschrijving, dan kun je er later één intrekken zonder de rest stil te leggen.

Behandel het als een wachtwoord

Wie je token heeft, kan alles wat dat token mag. Bij het aanmaken kies je dat zelf; geef niet meer rechten dan nodig. Zet het niet in een gedeeld document en niet in code die je publiceert.

Vermoed je dat het ergens terecht is gekomen waar het niet hoort, trek het dan in en maak een nieuw aan. Vanaf dat moment werkt het oude direct niet meer.

In het overzicht zie je per token wanneer het voor het laatst gebruikt is. Een token dat nooit gebruikt is of maanden stilligt, kun je zonder zorgen intrekken.

Je eerste aanroep

Elke aanroep gaat naar het webadres van je eigen ticketshop en draagt je token. Dit voorbeeld geeft je omzet van vorige maand, uitgesplitst naar de bron waar de bezoeker vandaan kwam.

Verzoek

curl -H "Access-Token: JOUW_TOKEN" \
  "https://jouwshop.avayo.nl/api/v2/analytics/sales\
?from=2026-08-01&to=2026-08-31\
&group_by=utm_source\
&metrics=orders,tickets,revenue"

Antwoord

{
  "meta": {
    "date_basis": "order_date",
    "timezone":   "Europe/Amsterdam",
    "currency":   "EUR",
    "amounts_in": "euro",
    "grain":      "order",
    "count":      2
  },
  "data": [
    { "utm_source": "facebook",    "orders": 84, "tickets": 197, "revenue": 4312.50 },
    { "utm_source": "nieuwsbrief", "orders": 39, "tickets": 106, "revenue": 2384.00 }
  ]
}

Werkt dat? Dan ben je klaar om verder te kijken. Weet je niet welke uitsplitsingen er zijn, vraag het dan de API zelf met /api/v2/analytics/dimensions.

Waar je verder kunt kijken

Conventies	Hoe authenticatie werkt, hoe een foutmelding eruitziet, en hoe lijsten gepagineerd zijn. Eén keer lezen bespaart je later uitzoekwerk.
Webhooks	Ons je systeem laten waarschuwen zodra er een bestelling betaald is, in plaats van steeds zelf komen vragen.
MCP-koppeling	Je AI-assistent de cijfers zelf laten opvragen. Adres instellen, token erbij, klaar.
Analytics API	Verkoopcijfers uitsplitsen naar campagne, kanaal, product en tijd, het verkoopverloop tegen de eventdatum, en verkocht tegenover gescand.

Evenementen, voorstellingen, producten en de rest van je catalogus lees en beheer je via de Beheer API. De scanner-endpoints staan nog op de rol; heb je daar nu al iets voor nodig, laat het weten — dat helpt ons bepalen wat er als eerste komt.