What can I build with this endpoint?

Registrations, results, and check-in already live in Intervals — the API is how you hand that data off to the vendors around your race: export entrants to your timing company or transponder system, generate a bib-printing or packet-pickup file, or pull a roster and headcount for your medal and apparel order, without emailing spreadsheets.

What is bibIdentifier for?

Bridge to your timing and packet-pickup workflow — map each bib to its entrant to import or reconcile results from your timing partner, or generate a bib-printing and packet list.

What are participantStatus and checkedIn useful for?

Check-in and finish happen inside Intervals — the API is how you fan that state out. Read checked-in and finisher status to fire your own finisher emails, update a CRM, or push a results feed to a downstream partner.

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)

limitnumberrequired

Items per page (1-100, default 50).

afterstring

Opaque cursor from a previous response's `cursor` field; returns the next page.

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

Lifecycle status: confirmed | cancelled | waitlist | refunded.

Available options: confirmed,cancelled,waitlist,refunded

participantStatusenum<string>

Available options: registered,checked_in,started,finished,dnf,dns,disqualified

paceGroupstring

Pace group assignment

bibIdentifierstring

Bib number

checkedInboolean

Whether participant has checked in

teamIdstring

The team this runner runs for. Group participants by it to reconstruct a team.

{
  "data": [
    {
      "id": "p89xyz345uvw678",
      "eventId": "e72tuv901wxy234",
      "eventRunId": "r41abc567def890",
      "email": "runner@example.com",
      "name": "Alex Johnson",
      "registrationType": "free",
      "registrationStatus": "confirmed",
      "participantStatus": "checked_in",
      "checkedIn": true
    },
    {
      "id": "p89stu901vwx234",
      "eventId": "e72tuv901wxy234",
      "eventRunId": "r41ghi234jkl567",
      "email": "captain@example.com",
      "name": "Priya Raman",
      "registrationType": "free",
      "registrationStatus": "confirmed",
      "participantStatus": "registered",
      "checkedIn": false,
      "teamId": "t55def678ghi901"
    }
  ],
  "hasMore": false
}

What you can build

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",
      "participantStatus": "checked_in",
      "checkedIn": true
    },
    {
      "id": "p89stu901vwx234",
      "eventId": "e72tuv901wxy234",
      "eventRunId": "r41ghi234jkl567",
      "email": "captain@example.com",
      "name": "Priya Raman",
      "registrationType": "free",
      "registrationStatus": "confirmed",
      "participantStatus": "registered",
      "checkedIn": false,
      "teamId": "t55def678ghi901"
    }
  ],
  "hasMore": false
}