Skip to main content
GET
List participants for a race

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

The race's id.

Query Parameters

eventOccurrenceId
string | null

A search query to filter race participants by event occurrence id.

Example:

"1353673654"

page[size]
number | null

How many results to return per page, from 1 to 500. Defaults to 100.

Required range: 1 <= x <= 500
Example:

100

page[after]
string | null

Pass page.next from the previous response to get the next page.

page[before]
string | null

Pass page.prev from the previous response to get the previous page.

sort[updatedAt]
enum<string> | null

Sort by update date. 1 for ascending, -1 for descending.

Available options:
1,
-1,
null
Example:

"1"

sort[createdAt]
enum<string> | null

Sort by creation date. 1 for ascending, -1 for descending.

Available options:
1,
-1,
null
Example:

"1"

createdAt[after]
string<date-time> | null

Only return entries created after this date.

Example:

"2020-01-01T20:15:00.000Z"

createdAt[before]
string<date-time> | null

Only return entries created before this date.

Example:

"2020-01-01T20:15:00.000Z"

updatedAt[after]
string<date-time> | null

Only return entries updated after this date.

Example:

"2020-01-01T20:15:00.000Z"

updatedAt[before]
string<date-time> | null

Only return entries updated before this date.

Example:

"2020-01-01T20:15:00.000Z"

extendMetadata
boolean | null

If set to true, all available metadata is returned.

features
string | null

A comma-separated list of optional features to enable for the request. Each feature extends the response with additional fields or behaviors.

  • tags — Adds the tags your team put on each entry, such as "injured" or "deferral".
  • gdpr_redacted — Says whether an entry was redacted after a GDPR request, so you can hide it in your own systems.
  • boolean_value — Adds true or false to agreement, confirmation and yes/no answers in Field entries, so you don't have to interpret the answer text.
  • withdrawn_status — Reports withdrawn entries as "WITHDRAWN". Without it they're reported as "CANCELLED".
  • status_details — Adds the reason and time of each status change, such as a deferral, a withdrawal or an approval decision.
  • race_day_details — Includes check-in time, waiver-signature time, and custom race-day fields.
  • result_submissions — Includes self-reported finish times (chip time and verification artifacts).
  • teams — Includes team membership, captain status, and team number, for team-based events.
  • waves — Includes start-wave assignments, for events that split the field into staggered starts.
Example:

"tags,waves"

Response

200 - application/json

A page of the race's participants.

data
Participant · object[]
required
page
PageCursor · object
required

Where you are in a paginated list.

Pass next as page[after] to get the next page, or prev as page[before] to get the previous one. An empty cursor means there are no more pages in that direction. Treat cursors as opaque strings.

Example: