ULTRACYCLINGHUB.
ENLanguage
Menu
My season 0

For developers and AI agents

THE DATA,
OPEN.

The same source-backed facts riders see, ready for your tools. Read published events, approved editions and their sources as JSON or Markdown.

Open the API schema

Start here

MAKE YOUR FIRST REQUEST.

No API key required. Access is read-only and responses allow any origin to read them. Please keep requests modest. Records are in English, whatever the language of this page.

Example · upcoming road editions

curl "https://ultracyclinghub.com/api/editions.json?discipline=road&period=upcoming&limit=3"

The response includes results, the total count and a next URL for the following page.

View this JSON response

ENDPOINT REFERENCE.

Use the directory’s filters to find editions, then read a complete event or a single edition. The schema documents the available fields and filters.

GET/api/editions.json

Search editions

Search with the directory’s filters. Paginate with page and limit, up to 100 records per page. An invalid filter returns HTTP 400 with field errors.

GET/api/openapi.json

API schema

The OpenAPI description of the search and record endpoints.

GET/events/<slug>.json

One event

Read an event with all its approved editions and sources. Replace .json with .md for Markdown.

GET/events/<slug>/<year>/<id>.json

One edition

Use the edition’s record id, alongside the event slug and year. The data URL includes this ID even when the HTML page does not. Markdown is also available at .md.

GET/changes.atom

Published fact changes

An Atom feed of corrections to published facts.

Prefer Markdown from an HTML event or edition URL? Send the Accept: text/markdown header.

FOR AI AGENTS.

Connect over MCP

The stateless HTTP server accepts POST requests and provides two read-only tools: search_events and get_event.

Server URLhttps://ultracyclinghub.com/mcp/
/llms.txt

Reading rules & coverage

Start with the data conventions, citation guidance and current coverage.

/llms-full.txt

The full collection

The same reading rules, followed by every published event as Markdown.

USE THE DATA WITH CARE.

Keep the provenance
Each record carries its source_url and verified_on date. A missing value means it is not verified, never zero or absent.
Attribute the source
The data is licensed CC BY 4.0. Link the event or edition page, name “Ultracycling Hub”, and give the record’s verification date.
Confirm before entering
Entry details, prices and dates change. Send riders to the organizer to enter. Read how listings are verified.
Report a data problem