Calendar API

Show the Randonneurs.be calendar on your own website. Free, read-only JSON — no key, no sign-up, and it can be called straight from the browser (CORS).

Address
https://randonneurs.be/api/v1/rides
Fair use
500 requests per hour per IP address. Answers may be up to 15 minutes old — please cache them too.
Contents
Rides organised in Belgium (BRM, RM, Flèche …) and Paris-Brest-Paris, cancelled ones included with "cancelled": true. Permanent rides (PeRM) with type=perm. No personal data.
Statistics
We count calls per day and per calling website or program — no IP addresses. Please add &client=your-site so we know who to tell about changes.
Calendar app
For Google, Apple or Outlook calendars there is an iCal subscription with the same filters: https://randonneurs.be/calendar.ics?type=brm&place=Leuven (also distance=200,300, postal; /kalender.ics and /calendrier.ics in Dutch and French).
Stability
v1 will not change in an incompatible way; ride ids never change. New fields may appear.

Example: all BRMs starting in Leuven

https://randonneurs.be/api/v1/rides?place=Leuven&type=brm

Only upcoming rides by default. Past seasons too: add &season=2025,2026,2027 (a season runs November–October), or a date range with from / to.

fetch('https://randonneurs.be/api/v1/rides?place=Leuven&type=brm')
  .then(r => r.json())
  .then(data => {
    for (const ride of data.rides) {
      console.log(ride.date, ride.start_time, ride.name, ride.url);
    }
  });

Questions or a field you miss? Use the contact form.

Reference

OpenAPI 3.1 description: JSON · YAML