1. RunSignup
  2. API
  3. Methods
  4. Look Up Race Series Participants (BETA)

Look Up Race Series Participants (BETA)

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.

Request Format

{
	"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"]
	]
}

Response Format

{
	"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."
		}
	]
}

URL

https://www.givesignup.org/rest/v2/race-series/race-series-participants/lookup.json

HTTP Method

POST

Parameters

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

If you continue to use this site, you consent to use all cookies. We use cookies to offer you a better browsing experience. Read how we use cookies and how you can control them by visiting our Privacy Policy.

If you continue to use this site, you consent to use all cookies.