Look up race series participants.
In the response format, when the race_series_participant_id
is not null, an exact match has been found.
If potential matches are found, they will be listed in the possible_matches
array.
If both race_series_participant_id
is null and possible_matches
is empty, no exact or potential match was found.
The errors
array will contain any errors encountered during the matching process.
Note: This endpoint only allows OAuth 2.0 authentication and requires the user to be a director of the race series. It is currently in beta and subject to change.
{ "columns": [ "registration_id", "user_id", "user_defined_id", "first_name", "last_name", "gender", "dob", "age", "email", "phone", "address1", "city", "state", "zipcode", "countrycode" ], "participants": [ [622, null, null, "Dolores", "Nguyen", "F", "1981-06-25", 40, "dolores.nguyen@example.com", "856-655-7878", "1899 Saddle Dr", "Moorestown", "NJ", "08057", "US"], [2650151, null, null, "Judd", "Daniels", "M", "1999-06-01", 27, "judd.daniels@example.com", "856-665-1683", "5833 College St", "Moorestown", "NJ", "08057", "US"], [2649769, null, null, "Washington", "Campbell", "M", "1974-01-18", 52, "Test.daniels@example.com", "888-888-8888", "300 Mill St", "Moorestown", "NJ", "08057", "US"], [2649697, null, null, "J", "Bailey", "M", "1967-03-13", 59, "Test1.daniels@example.com", "888-888-8888", "300 Mill St", "Moorestown", "NJ", "08057", "US"] ] }
{ "race_series_participants": [ { "row": 1, "race_series_participant_id": null, "possible_matches": [ { "registration_id": null, "user_id": null, "race_series_participant_id": 3862, "user_defined_id": null, "first_name": "Dolores", "last_name": "Nguyen", "gender": "F", "dob": "1981-06-25", "age": 43, "email": "dolores.nguyen@example.com", "phone": "856-655-7878", "address1": "1899 Saddle Dr", "city": "Moorestown", "state": "NJ", "zipcode": "08057", "countrycode": "US" }, { "registration_id": null, "user_id": null, "race_series_participant_id": 3865, "user_defined_id": null, "first_name": "Dolores", "last_name": "Nguyen", "gender": "F", "dob": "1981-06-25", "age": 43, "email": "dnguyen@example.com", "phone": "856-657-7851", "address1": "198 Creek Rd", "city": "Moorestown", "state": "NJ", "zipcode": "08057", "countrycode": "US" } ] }, { "row": 2, "race_series_participant_id": 3861 }, { "row": 3, "race_series_participant_id": null, "possible_matches": [ { "registration_id": 3864, "user_id": 3048333, "race_series_participant_id": 3864, "user_defined_id": null, "first_name": "W", "last_name": "Campbell", "gender": "M", "dob": "1974-01-18", "age": 50, "email": "Test.daniels@example.com", "phone": "888-888-8888", "address1": "300 Mill St", "city": "Moorestown", "state": "NJ", "zipcode": "08057", "countrycode": "US" } ] }, { "row": 4, "race_series_participant_id": null, "error": "No match found." } ] }
Parameter | HTTP Method | Default | Description | Datatype |
---|---|---|---|---|
Authorization Required |
HTTP Header | OAuth 2.0 Authorization header (e.g. `Bearer ...`). | string |
|
race_series_id Required |
GET | Race series ID. | uint |
|
race_series_year_id Required |
GET | Race series year ID. | uint |
|
race_id Required |
GET | Race ID. | uint |
|
event_id Required |
GET | Event ID. | uint |
|
matching_type Required |
GET | Matching Type (registration_id, user_id, user_defined_id). | string |
|
request Required |
POST | JSON data containing participants to be used for lookup. | string |