Run This

For developers

Developer overview

What you can integrate with today, and where the general-purpose Run This API is headed.

Live today: the Timer API

Run This ships a production, key-authenticated API for timing companies — live rosters with delta sync, bib write-back, results upload, webhooks with signature verification, and CSV feeds. If you build timing software, start at the Timer API reference.

Public pages are also machine-readable: events, clubs, communities, and race-calendar pages each serve a Markdown mirror (append .md to the URL), and runthis.run/llms.txt indexes the catalog for answer engines and crawlers.

The general-purpose public API isn't live yet

Beyond the Timer API, the broader REST API is designed but not released. If you have a specific use case in mind — an aggregator integration, a training-app sync, a custom director tool — email hello@runthis.run and tell us what you'd build. It helps us prioritize.

Planned shape

  • REST + JSON, versioned via URL: api.runthis.run/v1/...
  • Personal Access Tokens (PATs) for authenticated requests.
  • Scoped tokens: read:user, read:director, write:director.
  • Webhooks for real-time event notifications.
  • OpenAPI 3 spec + generated docs site.

Public endpoints (planned)

  • List + view events (paginated, filterable).
  • View a user's public profile and trophies.
  • View a series, its member events.
  • The verified timer-company directory.
  • Public results for events that have published them.

Authenticated endpoints (planned)

  • Read your own profile, registrations, trophies.
  • Read events you direct, including registrations.
  • Upload results to an event you direct.
  • Configure and read webhook deliveries.