Gets participants for a specific event in a race, including the user information, registration date, and payment information.
Please note that this API returns results in pages.
The page
, results_per_page
, and sort
parameters can be used to control paging.
You should consider using after_registration_id
and/or modified_after_timestamp
to download registrations since the last API request when you download participants over time.
When using modified_after_timestamp
, note that it returns participants that have been modified on or after the specified timestamp.
If modified_after_timestamp
is used in conjunction with the highest returned modified timestamp for subsequent API calls, you may need to increment modified_after_timestamp
to prevent the same participant(s) from being returned each time.
signed_waiver_details
will only be returned when the include_multiple_waivers
parameter is set to T
and is only supported for the JSON format.
{ "event": { "event_id": 11111, "participants": [] }, "participants": [ { "user": { "user_id": 123123123, "first_name": "Margie", "middle_name": null, "last_name": "Stephens", "email": "margie.stephens@example.com", "address": { "street": "960 Avondale Ave", "city": "Moorestown", "state": "NJ", "zipcode": "08057", "country_code": "US" }, "dob": "1986-01-06", "gender": "F", "phone": "856-850-1510", "profile_image_url": null }, "registration_id": 2645624, "event_id": 12890, "rsu_transaction_id": 263659, "transaction_id": "ay_852631042119552C_0", "bib_num": null, "chip_num": null, "age": 35, "registration_date": "9/7/2021 15:15", "team_id": null, "team_name": null, "team_type_id": null, "team_type": null, "team_gender": null, "team_bib_num": null, "last_modified": 1631042122, "imported": "F", "race_fee": "$55.00", "offline_payment_amount": "$0.00", "processing_fee": "$2.75", "processing_fee_paid_by_user": "$2.75", "processing_fee_paid_by_race": "$0.00", "partner_fee": "$0.00", "affiliate_profit": "$0.00", "extra_fees": "$0.00", "amount_paid": "$57.75", "usatf_discount_amount_in_cents": "$0.00", "usatf_discount_additional_field": null, "giveaway": null, "giveaway_option_id": null "fundraiser_id": 12345, "fundraiser_charity_id": null, "fundraiser_charity_name": null, "team_fundraiser_id": null, "multi_race_bundle_id": null, "multi_race_bundle": null, "signed_waiver_details": [ { "waiver_id": 123, "waiver_signed_ts": 1694007359 }, { "waiver_id": 124, "waiver_signed_ts": 1694007359 } ] } ] }
Parameter | HTTP Method | Default | Description | Datatype |
---|---|---|---|---|
api_key |
GET | API Key | string |
|
api_secret |
GET | API Secret | string |
|
tmp_key |
GET | Temporary API Key from login API call. This should NOT be used in combination with API Key. | string |
|
tmp_secret |
GET | Temporary API Secret from login API call. This should NOT be used in combination with API Secret. | string |
|
rsu_api_key |
GET | API v2 key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET. | string |
|
sp_api_key |
GET | Super partner API key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET. | string |
|
X-RSU-API-SECRET |
HTTP Header | API v2 or super partner secret. | string |
|
format |
GET | xml | Format of response. The default if not sent is `xml`, but `json` is preferred. | format |
Parameter | HTTP Method | Default | Description | Datatype |
---|---|---|---|---|
race_id Required |
GET | ID of race. | uint |
|
event_id Required |
GET | ID of event or list of event IDs separated by commas. | id_list |
|
page |
GET | 1 | Page number to get. | uint |
results_per_page |
GET | 50 | Number of results per page. | uint |
sort |
GET | registration_id ASC | Sort by "registration_id", "registration_date", "age", "name", "first_name", "last_name", "bib_num", "chip_num", "gender" in ascending ("ASC") or descending ("DESC") order. | string |
after_registration_id |
GET | Get registrations after the given registration ID | int |
|
before_registration_id |
GET | Get registrations before the given registration ID | int |
|
modified_after_timestamp |
GET | Get registrations modified on or after a given time | unix_timestamp |
|
registered_after_timestamp |
GET | Get registrations registered on or after a given time | unix_timestamp |
|
registered_before_timestamp |
GET | Get registrations registered on or before a given time | unix_timestamp |
|
include_counties |
GET | F | Should the US counties (NOT COUNTRY) be included. | bool |
include_template_participant |
GET | F | Should a template participant be included. Registration ID will be -1. | bool |
include_user_anonymous_flag |
GET | F | Should the is_anonymous flag be included on users? | bool |
include_questions |
GET | F | Should question responses be included. Ignored for CSV response type. | bool |
include_corrals |
GET | F | Should corrals be included. | bool |
include_est_finish |
GET | F | Should estimated finish times be included. | bool |
include_corp_teams |
GET | F | Should corporate teams be included. | bool |
include_registration_addons |
GET | F | Should registration add-ons be included. Ignored for CSV response type. | bool |
include_memberships |
GET | F | Should registration memberships be included. Ignored for CSV response type. | bool |
include_coupon_details |
GET | F | Should coupon details be included. | bool |
include_registration_notes |
GET | F | Should registration notes be included. | bool |
include_checkin_data |
GET | F | Should checkin data be included. | bool |
include_waiver_info |
GET | F | Should waiver info be included. | bool |
include_multiple_waivers |
GET | F | Should info for multiple waivers be included? | bool |
include_usat_waiver_info |
GET | F | Should USAT waiver info be included. | bool |
include_pending_lottery_selection |
GET | F | Should pending lottery selection participants be included. | bool |
exclude_registrations_via_super_event |
GET | F | Exclude event registrations that are due to the registrant signing up for a super event that includes this event. | bool |
include_shipping_address |
GET | F | Should shipping address be included (if enabled). | bool |
include_profile_type |
GET | F | Should profile type be included. | bool |
include_profile_image_url |
GET | F | Should profile image URLs be included. | bool |
supports_nb |
GET | F | Does integration support non-binary X gender? | bool |
include_fundraisers |
GET | F | Should fundraiser and team fundraiser information be included? | bool |
include_multi_race_bundle_info |
GET | F | Should multi-race bundle information be included? | bool |
Parameter | HTTP Method | Default | Description | Datatype |
---|---|---|---|---|
search_first_name |
GET | Search for users by first name. | string |
|
search_last_name |
GET | Search for users by last name. | string |
|
search_email |
GET | Search for users by email address. | string |
|
search_bib |
GET | Search for users by bib number. | uint |