Skip to main content

Participant Downloads

Download participant registrations from Race Roster into RunScore using the Race Roster API Participants endpoints.

When downloaded participants include teamId values, RunScore automatically retrieves team data from the API and includes it with each participant record. See Participant Fields for the full field reference.

Before you start​

  1. Start the RunScore application.
  2. Open the race you want to download participants into.
  3. Make sure your race database has fields for the participant data you need from Race Roster.

Enable Race Roster​

  1. Select Race Roster as your online system: Tools → Online system → RaceRoster.

Tools → Online system → RaceRoster

Log in and select a race​

  1. Open the Online menu and choose Login.

Online System: Race Roster menu — Login

  1. Select the race to download from: Online → Select race → Future races or All races.

Select race — Future races or All races

Sub-event selection

For events with multiple sub-events (5K, 10K, Half Marathon), RunScore prompts you to choose which sub-events to download. RunScore retains your sub-event selections for subsequent downloads.

Download participants​

  1. Choose Online → Download registrations → Download registrations.

  2. Map fields as prompted. Mapping is automatic when API field names match your RunScore column names. See Participant Fields for field descriptions.

Field mapping dialog — match API fields to RunScore columns

When mapping, Ignore all remaining fields skips all unmapped fields for the current participant and moves to the next one.

  1. Complete the download.
Edit mapping later

Use Online → Download registrations → Edit Mapping to adjust field mappings after your first download.

Incremental download​

After your initial download, use Online → Download registrations → Incremental Download to fetch new registrations and changes since the last download.

Use incremental downloads during the registration period and on race day to keep RunScore in sync with Race Roster without re-downloading the entire roster.