Intervals Developers
API Reference
Sign inGet API key
IntroductionAuthenticationErrorsPaginationRate LimitsIdempotency

Endpoints

GETYour organizationGETAll eventsGETRetrieve an eventPOSTCreate an eventGETAll registrationsPOSTRegister a participantGETAll recurrencesGETAll groupsGETRetrieve a groupGETEvents in a group
Changelog
Sign inGet API key

Endpoints

All registrations

Retrieve a list of registrations for a specific event.

GET/registration
curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/registration?eventId=e72tuv901wxy234

Query Parameters

eventIdstringrequired

Filter by event ID (required)

limitnumber

Maximum number of registrations to return (1-100)

Authorization

read:participants

Response

_idstringrequired

Registration ID

eventIdstringrequired

Event ID

eventRunIdstringrequired

Event run ID

emailstringrequired

Participant email

namestring

Participant name

registrationTypeenum<string>required

Registration type

Available options: free,paid

registrationStatusenum<string>required

Registration status

Available options: confirmed,cancelled,waitlist,refunded

paceGroupstring

Pace group assignment

bibIdentifierstring

Bib number

checkedInboolean

Whether participant has checked in

{
  "data": [
    {
      "_id": "p89xyz345uvw678",
      "eventId": "e72tuv901wxy234",
      "eventRunId": "r41abc567def890",
      "email": "runner@example.com",
      "name": "Alex Johnson",
      "registrationType": "free",
      "registrationStatus": "confirmed",
      "checkedIn": false
    }
  ]
}
Create an eventRegister a participant

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/registration?eventId=e72tuv901wxy234

Response

{
  "data": [
    {
      "_id": "p89xyz345uvw678",
      "eventId": "e72tuv901wxy234",
      "eventRunId": "r41abc567def890",
      "email": "runner@example.com",
      "name": "Alex Johnson",
      "registrationType": "free",
      "registrationStatus": "confirmed",
      "checkedIn": false
    }
  ]
}