Webhooks and API
Connect your CRM, timing system or membership admin. WandelWeb sends a signed HTTP POST for every relevant event.
Overview
Each organisation can register one or more webhook URLs in Settings → Integrations. You choose which events you receive. Every message has a unique event_id; use it as an idempotency key.
Payloads contain personal data of participants. You are the controller for what you store. Keep secrets safe and never share them.
Webhooks
WandelWeb POSTs a JSON envelope to your HTTPS URL. HTTP is allowed in local development. Private and loopback addresses are rejected.
Below is a sample payload per event, generated from the same resources as live deliveries.
order.paid
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "order.paid",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"public_id": "01M3NVM1D65F3493W6PJPEBWG7",
"status": "paid",
"source": "web",
"channel": null,
"email": "koper@example.test",
"first_name": "Anna",
"last_name": "de Vries",
"phone": "0693201182",
"locale": "nl",
"totals": {
"subtotal_cents": 1000,
"discount_cents": 0,
"platform_fee_cents": 77,
"total_cents": 1093,
"currency": "EUR"
},
"paid_at": "2026-09-29T05:53:52+00:00",
"invoice_number": null,
"lines": [
{
"description": "Regulier",
"quantity": 1,
"unit_price_cents": 1250,
"total_cents": 1363,
"vat_rate": 9
}
],
"tickets": [
{
"public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"ticket_number": "DUIN-000001",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Anna",
"last_name": "de Vries",
"email": "anna@example.test",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
},
{
"public_id": "01M3NVM1DKNVZ1GPXS5V6VG7J6",
"ticket_number": "DUIN-000002",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Bert",
"last_name": "Jansen",
"email": "robb36@example.org",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
}
]
}
}
order.refunded
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "order.refunded",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"id": 9,
"order_public_id": "01M3NVM1D65F3493W6PJPEBWG7",
"status": "pending",
"amount_cents": 1250,
"currency": "EUR",
"reason": "organiser_decision",
"ticket_ids": [],
"processed_at": null
}
}
ticket.issued
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "ticket.issued",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"ticket_number": "DUIN-000001",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Anna",
"last_name": "de Vries",
"email": "anna@example.test",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
}
}
ticket.updated
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "ticket.updated",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"ticket_number": "DUIN-000001",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Anna",
"last_name": "de Vries",
"email": "anna@example.test",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
}
}
ticket.cancelled
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "ticket.cancelled",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"ticket_number": "DUIN-000001",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Anna",
"last_name": "de Vries",
"email": "anna@example.test",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
}
}
ticket.replaced
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "ticket.replaced",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"previous_ticket": {
"public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"ticket_number": "DUIN-000001",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Anna",
"last_name": "de Vries",
"email": "anna@example.test",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
},
"ticket": {
"public_id": "01M3NVM1DKNVZ1GPXS5V6VG7J6",
"ticket_number": "DUIN-000002",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Bert",
"last_name": "Jansen",
"email": "robb36@example.org",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
}
}
}
ticket.checked_in
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "ticket.checked_in",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"id": 3,
"ticket_public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"scan_post": {
"id": 12,
"name": "Start",
"type": "check_in"
},
"scanned_at": "2026-09-29T05:53:52+00:00",
"method": "qr",
"result": "valid"
}
}
event.published
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "event.published",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"id": 173,
"public_slug": "duinentocht",
"title": "Duinentocht",
"starts_at": "2026-12-30T09:00:00+00:00",
"ends_at": "2026-12-30T22:59:59+00:00",
"timezone": "Europe/Amsterdam",
"status": "published",
"distances": [
{
"id": 23,
"name": "25 km",
"distance_km": 25
}
],
"ticket_types": [
{
"id": 226,
"name": "Regulier",
"price_cents": 1250
}
]
}
}
event.cancelled
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "event.cancelled",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"id": 173,
"public_slug": "duinentocht",
"title": "Duinentocht",
"starts_at": "2026-12-30T09:00:00+00:00",
"ends_at": "2026-12-30T22:59:59+00:00",
"timezone": "Europe/Amsterdam",
"status": "published",
"distances": [
{
"id": 23,
"name": "25 km",
"distance_km": 25
}
],
"ticket_types": [
{
"id": 226,
"name": "Regulier",
"price_cents": 1250
}
]
}
}
waitlist.entry_created
{
"id": "01EXAMPLEEVENTID0000000000",
"type": "waitlist.entry_created",
"version": "2026-09-01",
"created_at": "2026-09-01T10:00:00+00:00",
"organiser": {
"id": 311,
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging"
},
"event": {
"id": 173,
"slug": "duinentocht",
"title": "Duinentocht"
},
"data": {
"id": 12,
"email": "wacht@example.test",
"quantity": 1,
"position": 1,
"ticket_type": {
"id": 226,
"name": "Regulier"
}
}
}
Verify the signature
Every delivery has the X-WandelWeb-Signature header in the form v1=<hex>. Compute HMAC-SHA256 over "<timestamp>.<body>" with your webhook secret and compare in constant time. Only accept timestamps within a five-minute window.
Use event_id (header X-WandelWeb-Event-Id and the id field in the body) to ignore duplicates. Redeliveries keep the same event_id.
PHP
$timestamp = $_SERVER['HTTP_X_WANDELWEB_TIMESTAMP'] ?? '';
$signature = $_SERVER['HTTP_X_WANDELWEB_SIGNATURE'] ?? '';
$body = file_get_contents('php://input');
if (abs(time() - (int) $timestamp) > 300) {
http_response_code(401);
exit;
}
$expected = 'v1='.hash_hmac('sha256', $timestamp.'.'.$body, $secret);
if (! hash_equals($expected, $signature)) {
http_response_code(401);
exit;
}
Node.js
const crypto = require('crypto');
const timestamp = req.get('X-WandelWeb-Timestamp');
const signature = req.get('X-WandelWeb-Signature');
const body = req.rawBody; // raw bytes, not parsed JSON
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) {
return res.status(401).end();
}
const expected = 'v1=' + crypto.createHmac('sha256', secret)
.update(`${timestamp}.${body}`)
.digest('hex');
if (! crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature))) {
return res.status(401).end();
}
Retries and disabling
A failed delivery (non-2xx, timeout, DNS or TLS error) is retried after 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours. After that the delivery stops.
After twenty consecutive failures WandelWeb disables the webhook and e-mails the owner and admins. You can turn it back on yourself.
Privacy
Webhook payloads include names, e-mail addresses, phone numbers, form answers and start numbers. The organiser is the controller; the webhook recipient is responsible for secure storage and retention.
Secrets are stored encrypted and shown only once. Rotate a secret immediately if it leaked.
Read API with API keys
With the read API your own systems fetch events, ticket types, orders, tickets, check-ins and statistics. The API is read-only: changes are only made in WandelWeb itself.
An owner or admin creates an API key under Settings → Integrations. The key belongs to the organisation, not to a person, so it keeps working when someone leaves the team. You only see the key once; afterwards only its last four characters. Give a key an expiry date and revoke it straight away if it leaks.
Send the key as Authorization: Bearer <key>. Every URL starts with /api/organiser/v1/organisers/{slug}; a key only works for its own organisation. Responses are JSON with data, links and meta; lists are paginated with page and per_page (default 50, maximum 200). Times are ISO 8601 in UTC, amounts in cents.
Sync with updated_since (orders and tickets, oldest change first). Each key may make 300 requests per minute; above that you get 429 with a Retry-After header. Combine the API with webhooks for real-time updates.
Versioning: within v1 fields are only added; nothing is ever removed or renamed. Ignore unknown fields. A breaking change gets a new version (/v2). Every response has the X-WandelWeb-Api-Version header.
Privacy: responses contain names, e-mail addresses, phone numbers, form answers and start numbers. The organiser is the data controller; store this data securely and no longer than needed. Responses carry Cache-Control: no-store.
Endpoints
- GET /
- Organisation details.
- GET /events
- Events with ticketing. Filters: status[], from, to.
- GET /events/{id}
- One event with distances, ticket types and key figures.
- GET /events/{id}/ticket-types
- Ticket types with price, capacity and sold.
- GET /events/{id}/orders
- Orders. Filters: status[], updated_since, email.
- GET /orders/{public_id}
- One order with lines and tickets.
- GET /events/{id}/tickets
- Tickets (valid by default). Filters: status[], ticket_type_id, distance_id, bib_number, search, updated_since.
- GET /tickets/{public_id}
- One ticket with check-ins.
- GET /events/{id}/check-ins
- Scans, newest first. Filters: scan_post_id, since, result.
- GET /events/{id}/stats
- Sales and check-in counters.
- GET /webhooks
- Your webhooks, without secrets.
Example
curl -H "Authorization: Bearer <api-key>" \
-H "Accept: application/json" \
"https://wanderweb.app/api/organiser/v1/organisers/voorbeeld-wandelvereniging/events/123/tickets?updated_since=2026-09-01T00:00:00Z&per_page=200"
Error codes
- 401
- Missing, unknown, expired or revoked key.
- 403
- Key without read access, organisation blocked or API turned off by WandelWeb.
- 404
- Unknown or different organisation, or an object that does not belong to this organisation.
- 422
- Invalid filter value.
- 429
- Too many requests; wait the number of seconds in Retry-After.
Example responses. For lists, data is an array and links and meta are added.
GET /
{
"data": {
"id": 311,
"slug": "voorbeeld-wandelvereniging",
"name": "Voorbeeld Wandelvereniging",
"website": "https://nicolas.com/nostrum-et-sit-iure-quisquam.html",
"timezone": "Europe/Amsterdam",
"api_version": "1"
}
}
GET /events/{id}/ticket-types
{
"data": {
"id": 226,
"name": "Regulier",
"description": "",
"distance_id": null,
"price_cents": 1250,
"current_price_cents": 1250,
"vat_rate": 9,
"currency": "EUR",
"fee_paid_by": "buyer",
"visibility": "public",
"capacity": null,
"sold_count": 0,
"reserved_count": 0,
"available": null,
"min_per_order": 1,
"max_per_order": 10,
"sales_start_at": null,
"sales_end_at": null,
"sort_order": 0
}
}
GET /orders/{public_id}
{
"data": {
"public_id": "01M3NVM1D65F3493W6PJPEBWG7",
"status": "paid",
"source": "web",
"channel": null,
"email": "koper@example.test",
"first_name": "Anna",
"last_name": "de Vries",
"phone": "0693201182",
"locale": "nl",
"totals": {
"subtotal_cents": 1000,
"discount_cents": 0,
"platform_fee_cents": 77,
"total_cents": 1093,
"currency": "EUR"
},
"paid_at": "2026-09-29T05:53:52+00:00",
"invoice_number": null,
"lines": [
{
"description": "Regulier",
"quantity": 1,
"unit_price_cents": 1250,
"total_cents": 1363,
"vat_rate": 9
}
],
"tickets": [
{
"public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"ticket_number": "DUIN-000001",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Anna",
"last_name": "de Vries",
"email": "anna@example.test",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
},
{
"public_id": "01M3NVM1DKNVZ1GPXS5V6VG7J6",
"ticket_number": "DUIN-000002",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Bert",
"last_name": "Jansen",
"email": "robb36@example.org",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null
}
],
"created_at": "2026-09-29T05:53:52+00:00",
"updated_at": "2026-09-29T05:53:52+00:00"
}
}
GET /tickets/{public_id}
{
"data": {
"public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9",
"ticket_number": "DUIN-000001",
"status": "valid",
"ticket_type": {
"id": 226,
"name": "Regulier"
},
"distance": null,
"holder": {
"first_name": "Anna",
"last_name": "de Vries",
"email": "anna@example.test",
"phone": null,
"date_of_birth": null,
"gender": null,
"city": null
},
"emergency_contact": null,
"answers": [],
"bib_number": null,
"time_slot": null,
"wave": null,
"team": null,
"check_ins": [
{
"id": 3,
"scan_post_id": 12,
"scan_post_name": "Start",
"scanned_at": "2026-09-29T05:53:52+00:00",
"result": "valid"
}
],
"progress": {
"status": "on_course",
"started_at": "2026-09-29T05:53:52+00:00",
"last_seen": {
"scan_post_id": 12,
"scan_post_name": "Start",
"scanned_at": "2026-09-29T05:53:52+00:00"
},
"finished_at": null,
"is_overdue": false
},
"updated_at": "2026-09-29T05:53:52+00:00"
}
}
GET /events/{id}/stats
{
"data": {
"event_id": 173,
"sales": {
"sold": 0,
"reserved": 0,
"capacity": null,
"per_ticket_type": [
{
"ticket_type_id": 226,
"name": "Regulier",
"sold": 0,
"reserved": 0,
"capacity": null,
"available": null
}
],
"per_distance": [
{
"distance_id": 23,
"name": "25 km",
"sold": 0,
"reserved": 0,
"capacity": null,
"available": null
}
]
},
"check_ins": {
"expected": 2,
"checked_in": 1,
"last_scan_at": "2026-09-29T05:53:52+00:00",
"per_scan_post": [
{
"scan_post_id": 12,
"name": "Start",
"type": "check_in",
"is_active": true,
"valid": 1,
"already_scanned": 0,
"invalid": 0
}
],
"per_distance": [
{
"distance_id": 23,
"name": "25 km",
"expected": 0,
"checked_in": 0,
"progress": {
"not_started": 0,
"on_course": 0,
"finished": 0,
"overdue": 0
}
}
],
"per_ticket_type": [
{
"ticket_type_id": 226,
"name": "Regulier",
"expected": 2,
"checked_in": 1
}
],
"per_time_slot": [],
"per_wave": []
},
"generated_at": "2026-09-29T05:53:52+00:00"
}
}
GET /webhooks
{
"data": {
"id": "01M3NVM1FW1JE5CRSEBS114W8B",
"url": "https://crm.example.test/wandelweb",
"description": "CRM",
"events": [
"order.paid"
],
"is_active": true,
"disabled_reason": null,
"last_delivered_at": null,
"last_failed_at": null,
"created_at": "2026-09-29T05:53:52+00:00"
}
}
Public API
Building your own website or app? The public API returns your events as JSON: title, date, location, distances and ticket types with price and availability. You do not need a key and the API never contains personal data.
Only published, sold-out, cancelled and finished events that sell tickets through WandelWeb are included. Hidden events and drafts are not.
Responses are cached for 60 seconds and carry an ETag. Send it back in If-None-Match to get 304 when nothing has changed. CORS is open to every website (without cookies), so you can call the API straight from the browser.
Each IP address may make 120 requests per minute; above that you get 429 with Retry-After. Cache the responses yourself if you have many visitors.
Versioning: this is version 1, shown in the header X-WandelWeb-Api-Version: 1. We only add fields. Fields are never removed or changed within version 1; that needs a new version on a separate address. Ignore unknown fields in your code.
Endpoints
- GET /api/public/events/{slug}
- One event with distances, ticket types, availability, labels and links to the event page and the checkout. Also works with the public_id of the event.
- GET /api/public/organisers/{slug}
- An organisation profile: name, logo, short description, website and the number of upcoming and past events.
- GET /api/public/organisers/{slug}/events
- The events of an organisation, per page. Upcoming events are ordered by start date, past events newest first.
- GET /api/public/oembed
- oEmbed 1.0 for an event URL; see the oEmbed section below.
Query parameters
- locale
- nl or en. Translates titles, labels and links. Without a locale you get the language the organiser wrote the event in.
- status
- Only for /events: upcoming (default), past or all.
- per_page
- Only for /events: 1 to 50, default 20. A higher value becomes 50.
- page
- Only for /events: page number, default 1. meta returns total, per_page, current_page and last_page.
- url
- Only for /oembed, required: the full URL of the event page on WandelWeb.
- format
- Only for /oembed: json (default) or xml.
- maxwidth, maxheight
- Only for /oembed: 200 to 2000 pixels. Below 560 pixels of height you get the card without the ticket overview.
Error codes
- 304
- Not modified since your ETag.
- 404
- Unknown, not public or not selling tickets through WandelWeb. For the organisation endpoints and oEmbed the response is {"error":"not_found"}.
- 422
- Invalid parameter, for example a URL outside WandelWeb for oEmbed.
- 429
- Too many requests; wait the number of seconds in Retry-After.
Example responses
GET /api/public/events/{slug}
{
"slug": "duinentocht",
"public_id": "01JEXAMPLEEVENT00000000000",
"url": "https://wandelweb.nl/nl/evenementen/duinentocht",
"title": "Duinentocht",
"description_html": "<p>Een tocht door de duinen van Castricum.</p>\n",
"description_plain": "Een tocht door de duinen van Castricum.",
"description_excerpt": "Een tocht door de duinen van Castricum.",
"status": "published",
"starts_at": "2027-05-15T09:00:00+02:00",
"ends_at": "2027-05-15T17:00:00+02:00",
"timezone": "Europe/Amsterdam",
"location": {
"name": "Castricum",
"latitude": 52.55,
"longitude": 4.63
},
"image_url": null,
"logo_url": null,
"accent_color": "#f65053",
"organiser": {
"name": "Voorbeeld Wandelvereniging",
"slug": "voorbeeld-wandelvereniging",
"url": "https://wandelweb.nl/nl/organisatoren/voorbeeld-wandelvereniging",
"logo_url": null
},
"distances": [
{
"id": 1,
"name": "25 km",
"distance_km": 25,
"starts_at": null,
"availability": {
"status": "available",
"label": "Beschikbaar",
"exact_count": null
},
"time_slot_mode": "none",
"time_slots": []
}
],
"ticket_types": [
{
"id": 1,
"name": "Regulier",
"description_html": "",
"description": null,
"price_cents": 1250,
"base_price_cents": 1250,
"currency": "EUR",
"price_formatted": "€ 12,50",
"fee_cents_for_buyer": 0,
"price_tier": null,
"next_price_cents": null,
"vat_rate": 9,
"availability": {
"status": "available",
"label": "Beschikbaar",
"exact_count": null
},
"sales_start_at": null,
"sales_end_at": null,
"distance_id": 1,
"min_per_order": null,
"max_per_order": null,
"waitlist": {
"enabled": false,
"open": false
}
}
],
"availability": {
"status": "available",
"tickets_left": null,
"lowest_price_cents": 1250,
"sales_open_at": null
},
"discount_rules": [],
"teams_enabled": false,
"transfer_policy": null,
"series": null,
"previous_editions": [],
"next_edition": null,
"checkout_url": "https://wandelweb.nl/nl/evenementen/duinentocht/tickets",
"embed_url": "https://wandelweb.nl/embed/events/duinentocht?lang=nl",
"labels": {
"order_tickets": "Tickets bestellen",
"sold_out": "Uitverkocht",
"not_yet_on_sale": "Nog niet in verkoop",
"sales_ended": "Verkoop gesloten",
"few_left": "Bijna uitverkocht",
"via_wandelweb": "Tickets via WandelWeb",
"available": "Tickets verkrijgbaar",
"tickets_left": "Nog :count tickets",
"sales_start": "Verkoop start :date",
"sales_closed": "Verkoop gesloten",
"from_price": "Vanaf :price",
"free": "Gratis",
"buy": "Tickets kopen",
"choose": "Kies",
"view_event": "Bekijk evenement",
"organised_by": "Georganiseerd door :name",
"powered_by": "Georganiseerd via WandelWeb",
"tickets_caption": "Tickets voor :event",
"price_tier_until": ":name tot :date",
"time_slots_available": "Starttijden met plek: :count",
"cancelled": "Geannuleerd"
},
"powered_by_url": "https://wandelweb.nl/nl/organisatoren/features/website-embed?utm_source=embed&utm_medium=widget&utm_campaign=duinentocht",
"generated_at": "2026-09-27T10:00:00+00:00"
}
GET /api/public/organisers/{slug}
{
"slug": "voorbeeld-wandelvereniging",
"name": "Voorbeeld Wandelvereniging",
"logo_url": null,
"description_excerpt": null,
"website": "https://www.voorbeeld-wandelvereniging.example",
"urls": {
"profile": "https://wandelweb.nl/nl/organisatoren/voorbeeld-wandelvereniging"
},
"events_count": {
"upcoming": 1,
"past": 0
}
}
GET /api/public/organisers/{slug}/events
{
"data": [
{
"slug": "duinentocht",
"public_id": "01JEXAMPLEEVENT00000000000",
"title": "Duinentocht",
"status": "published",
"starts_at": "2027-05-15T09:00:00+02:00",
"ends_at": "2027-05-15T17:00:00+02:00",
"timezone": "Europe/Amsterdam",
"location": {
"name": "Castricum"
},
"image_url": null,
"lowest_price_cents": 1250,
"labels": {
"order_tickets": "Tickets bestellen",
"sold_out": "Uitverkocht",
"not_yet_on_sale": "Nog niet in verkoop",
"sales_ended": "Verkoop gesloten",
"few_left": "Bijna uitverkocht",
"via_wandelweb": "Tickets via WandelWeb",
"available": "Tickets verkrijgbaar",
"tickets_left": "Nog :count tickets",
"sales_start": "Verkoop start :date",
"sales_closed": "Verkoop gesloten",
"from_price": "Vanaf :price",
"free": "Gratis",
"buy": "Tickets kopen",
"choose": "Kies",
"view_event": "Bekijk evenement",
"organised_by": "Georganiseerd door :name",
"powered_by": "Georganiseerd via WandelWeb",
"tickets_caption": "Tickets voor :event",
"price_tier_until": ":name tot :date",
"time_slots_available": "Starttijden met plek: :count",
"cancelled": "Geannuleerd"
},
"urls": {
"page": "https://wandelweb.nl/nl/evenementen/duinentocht"
},
"series": null
}
],
"meta": {
"total": 1,
"per_page": 20,
"current_page": 1,
"last_page": 1
}
}
GET /api/public/oembed
{
"version": "1.0",
"type": "rich",
"provider_name": "WandelWeb",
"provider_url": "https://wandelweb.nl/",
"title": "Duinentocht",
"author_name": "Voorbeeld Wandelvereniging",
"author_url": "https://wandelweb.nl/nl/organisatoren/voorbeeld-wandelvereniging",
"html": "<iframe src=\"https://wandelweb.nl/embed/events/duinentocht/card?locale=nl&variant=tickets\" width=\"100%\" height=\"560\" style=\"border:0;max-width:600px\" loading=\"lazy\" title=\"Duinentocht\"></iframe>",
"width": 600,
"height": 560,
"cache_age": 3600
}
oEmbed
Paste the link to your event into a website builder that supports oEmbed and a card appears with the date, location, price and a button to the tickets. The button opens the WandelWeb checkout in the same window, so payment always happens safely on WandelWeb.
Ghost, Notion and other platforms find the card through the discovery tags on the event page. WordPress only shows the card when WandelWeb is on the WordPress oEmbed list. If that does not work for you, use the embed code from the organiser dashboard.
Only public events that sell tickets get a card. Hidden events do not, so they are not shared through a pasted link.
Discovery tags on the event page
<link rel="alternate" type="application/json+oembed"
href="https://wanderweb.app/api/public/oembed?url=https%3A%2F%2Fwanderweb.app%2Fnl%2Fevenementen%2Fvoorbeeld-wandeltocht&format=json"
title="Voorbeeld Wandeltocht">
<link rel="alternate" type="text/xml+oembed"
href="https://wanderweb.app/api/public/oembed?url=https%3A%2F%2Fwanderweb.app%2Fnl%2Fevenementen%2Fvoorbeeld-wandeltocht&format=xml"
title="Voorbeeld Wandeltocht">
Adjusting the height
After loading and on every size change, the card sends a message to the page around it. Listen for it if you want to adjust the iframe height; without a listener the iframe keeps the fixed height from the oEmbed response.
window.addEventListener('message', (event) => {
if (event.data?.type !== 'wandelweb:resize') {
return;
}
const frame = [...document.querySelectorAll('iframe')]
.find((iframe) => iframe.contentWindow === event.source);
if (frame) {
frame.style.height = `${event.data.height}px`;
}
});
Embed code
Want more than a card, such as a ticket button, a badge or the full checkout on your own site? Create the embed code in the organiser dashboard under Website embed for your event. You see a live preview there.
Measuring sales with Google Analytics or Meta? Read how the embed works with your own tracking.