Get a list of results for all result sets for an event.
| Parameter | HTTP Method | Default | Description | Datatype |
|---|---|---|---|---|
api_key |
GET | API Key | string |
|
api_secret |
GET | 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 |
|
Authorization |
HTTP Header | Authorization Header. If using OAuth 2.0, fill this in with `Bearer <token>`. | 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_idRequired |
GET | ID of race. | uint |
|
event_idRequired |
GET | ID of event. | uint |
|
individual_result_set_id |
GET | ID of result set. | uint |
|
include_total_finishers |
F | Indicates whether or not to include total finishers in result set metadata. (Not supported for CSV) | bool |
|
include_split_time_ms |
F | Indicates whether or not to include milliseconds in split times. | bool |
|
modified_after_timestamp |
GET | Get results modified after a given timestamp | unix_timestamp |
|
supports_nb |
GET | F | Does integration support non-binary X gender? | bool |
| Parameter | HTTP Method | Default | Description | Datatype |
|---|---|---|---|---|
page |
GET | 1 | Page number to get. | uint |
results_per_page |
GET | 50 | Number of results per page. | uint |
| Parameter | HTTP Method | Default | Description | Datatype |
|---|---|---|---|---|
first_name |
Search for results by first name. | string |
||
last_name |
Search for results by last name. | string |
||
gender |
Search for results by gender. | gender |
||
bib_num |
Search for results by bib number. | uint |
||
registration_id |
Search for results by registration ID. | uint |
||
min_place |
Search for results by minimum finishing place. | uint |
||
max_place |
Search for results by maximum finishing place. | uint |
||
min_age |
Search for results by minimum age. | uint |
||
max_age |
Search for results by maximum age. | uint |
||
state |
Search for results by state. | state |
||
country |
Search for results by country. | country |
{
"openapi": "3.0.3",
"info": {
"title": "Get Event Results",
"description": "List all results for all result sets for an event.",
"version": "1.0.0",
"contact": {
"name": "RunSignup API Support",
"url": "https://runsignup.com/API",
"email": "info@runsignup.com"
}
},
"servers": [
{
"url": "https://api.runsignup.com/rest",
"description": "Production API Server"
}
],
"tags": [
{
"name": "Results",
"description": "APIs related to Results"
}
],
"components": {
"schemas": {
"Error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Error message"
},
"details": {
"type": "object",
"description": "Additional error details",
"additionalProperties": true
}
},
"required": [
"error"
]
},
"BadRequestError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating invalid request parameters or structure"
}
]
},
"UnauthorizedError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating authentication failure"
}
]
},
"ForbiddenError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating the authenticated user lacks required permissions"
}
]
},
"NotFoundError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating the requested resource does not exist"
}
]
},
"ServerError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating an unexpected server-side issue"
}
]
},
"Race_raceIdResultsGetResultsGetResponse": {
"type": "object",
"title": "Results Response",
"description": "List of results for an event",
"properties": {
"individual_results_sets": {
"type": "array",
"description": "List of result sets",
"items": {
"type": "object",
"description": "Result set information",
"properties": {
"individual_result_set_id": {
"type": "integer",
"description": "Result set ID"
},
"individual_result_set_name": {
"type": "string",
"description": "Result set name"
},
"public_results": {
"type": "string",
"description": "Whether results are public",
"enum": [
"T",
"F"
]
},
"sort_order": {
"type": "integer",
"description": "Sort order"
},
"results_source_name": {
"type": "string",
"description": "Results source name",
"nullable": true
},
"results_source_url": {
"type": "string",
"description": "Results source URL",
"nullable": true
},
"preliminary_results": {
"type": "string",
"description": "Whether results are preliminary",
"enum": [
"T",
"F"
]
},
"pace_type": {
"type": "string",
"description": "Pace type",
"enum": [
"T",
"F"
]
},
"team_column_display_type": {
"type": "integer",
"description": "Team column display type"
},
"alt_event_ids": {
"type": "array",
"description": "List of alternative event IDs",
"items": {
"type": "integer",
"description": "Alternative event ID"
}
},
"hide_splits_in_results": {
"type": "string",
"description": "Whether to hide splits in results",
"enum": [
"T",
"F"
]
},
"hide_event_names": {
"type": "string",
"description": "Whether to hide event names",
"enum": [
"T",
"F"
]
},
"disable_notifications": {
"type": "string",
"description": "Whether notifications are disabled",
"enum": [
"T",
"F"
]
},
"result_questions_url": {
"type": "string",
"description": "Result questions URL",
"nullable": true
},
"registration_ids": {
"type": "array",
"description": "List of registration IDs associated with the result set",
"items": {
"type": "integer",
"description": "Registration ID"
}
},
"num_finishers": {
"type": "integer",
"description": "Number of finishers. Present when include_total_finishers=T",
"x-response-field-inclusion": [
{
"request-parameter": "include_total_finishers",
"value": "T"
}
]
},
"num_division_finishers": {
"type": "object",
"description": "An object mapping division IDs to the number of finishers in each division. Present when include_total_finishers=T",
"nullable": true,
"x-response-field-inclusion": [
{
"request-parameter": "include_total_finishers",
"value": "T"
}
],
"additionalProperties": true,
"properties": {
"1": {
"description": "[EXAMPLE] Division 1 finisher count (This property is not required - the object can contain any properties)",
"example": 75,
"type": "integer"
},
"2": {
"description": "[EXAMPLE] Division 2 finisher count (This property is not required - the object can contain any properties)",
"example": 75,
"type": "integer"
}
},
"x-key-naming-convention": "Keys are division IDs (integers) mapping to finisher counts (integers)"
},
"results_headers": {
"type": "object",
"description": "Mapping of result column keys to display names. Present when include_split_time_ms=T",
"x-response-field-inclusion": [
{
"request-parameter": "include_split_time_ms",
"value": "T"
}
],
"additionalProperties": true,
"properties": {
"result_id": {
"description": "[EXAMPLE] Result Id (This property is not required - the object can contain any properties)",
"example": "Result Id",
"type": "string"
},
"place": {
"description": "[EXAMPLE] Place (This property is not required - the object can contain any properties)",
"example": "Place",
"type": "string"
},
"bib": {
"description": "[EXAMPLE] Bib (This property is not required - the object can contain any properties)",
"example": "Bib",
"type": "string"
},
"first_name": {
"description": "[EXAMPLE] First Name (This property is not required - the object can contain any properties)",
"example": "First Name",
"type": "string"
},
"last_name": {
"description": "[EXAMPLE] Last Name (This property is not required - the object can contain any properties)",
"example": "Last Name",
"type": "string"
},
"gender": {
"description": "[EXAMPLE] Gender (This property is not required - the object can contain any properties)",
"example": "Gender",
"type": "string"
},
"city": {
"description": "[EXAMPLE] City (This property is not required - the object can contain any properties)",
"example": "City",
"type": "string"
},
"state": {
"description": "[EXAMPLE] State (This property is not required - the object can contain any properties)",
"example": "State",
"type": "string"
},
"country_code": {
"description": "[EXAMPLE] Country (This property is not required - the object can contain any properties)",
"example": "Country",
"type": "string"
},
"clock_time": {
"description": "[EXAMPLE] Clock Time (This property is not required - the object can contain any properties)",
"example": "Clock Time",
"type": "string"
},
"chip_time": {
"description": "[EXAMPLE] Chip Time (This property is not required - the object can contain any properties)",
"example": "Chip Time",
"type": "string"
},
"pace": {
"description": "[EXAMPLE] Pace (This property is not required - the object can contain any properties)",
"example": "Pace",
"type": "string"
},
"age": {
"description": "[EXAMPLE] Age (This property is not required - the object can contain any properties)",
"example": "Age",
"type": "string"
},
"age_percentage": {
"description": "[EXAMPLE] Age Percentage (This property is not required - the object can contain any properties)",
"example": "Age Percentage",
"type": "string"
}
},
"x-pattern-properties": {
"split-\\d+": "Split time for a specific split (e.g., split-1, split-2)",
"split-\\d+-pace": "Split pace for a specific split (e.g., split-1-pace)",
"split-\\d+-place": "Split place for a specific split (e.g., split-1-place)",
"custom-field-\\d+": "Custom field value (e.g., custom-field-123)",
"division-\\d+-placement": "Division placement (e.g., division-1-placement)"
},
"x-key-naming-convention": "Keys follow the pattern: standard fields are lowercase with underscores, dynamic fields use hyphens and IDs (e.g., split-1, custom-field-123)"
},
"results": {
"type": "array",
"description": "List of results",
"items": {
"type": "object",
"description": "Individual result",
"properties": {
"result_id": {
"type": "integer",
"description": "Unique identifier for the result"
},
"place": {
"type": "integer",
"description": "Placement in the race"
},
"bib": {
"type": "integer",
"description": "Bib number"
},
"first_name": {
"type": "string",
"description": "First name of participant (may be \"Anonymous\" if privacy settings prevent display)"
},
"last_name": {
"type": "string",
"description": "Last name of participant (may be \"Anonymous\" if privacy settings prevent display)"
},
"gender": {
"type": "string",
"description": "Gender of participant"
},
"city": {
"type": "string",
"description": "City of participant",
"nullable": true
},
"state": {
"type": "string",
"description": "State/province of participant",
"nullable": true
},
"country_code": {
"type": "string",
"description": "Country code of participant",
"nullable": true
},
"clock_time": {
"type": "string",
"description": "Clock time in HH:MM:SS format"
},
"chip_time": {
"type": "string",
"description": "Chip time in HH:MM:SS format"
},
"pace": {
"type": "string",
"description": "Pace per mile/kilometer in MM:SS format (if pace type is enabled)"
},
"age": {
"type": "integer",
"description": "Age of participant"
},
"age_percentage": {
"type": "string",
"description": "Age performance percentage with % symbol"
}
},
"required": [
"result_id",
"place",
"bib",
"first_name",
"last_name",
"gender",
"city",
"state",
"country_code",
"clock_time",
"chip_time",
"age"
]
}
}
},
"required": [
"individual_result_set_id",
"individual_result_set_name",
"public_results",
"sort_order",
"preliminary_results",
"pace_type",
"team_column_display_type",
"alt_event_ids",
"hide_splits_in_results",
"hide_event_names",
"disable_notifications",
"results_headers",
"results"
]
}
}
},
"required": [
"individual_results_sets"
],
"example": {
"individual_results_sets": [
{
"individual_result_set_id": 842,
"individual_result_set_name": "Virtual Coffee",
"public_results": "T",
"sort_order": 0,
"results_source_name": null,
"results_source_url": null,
"preliminary_results": "F",
"pace_type": "T",
"team_column_display_type": 1,
"alt_event_ids": [],
"hide_splits_in_results": "F",
"hide_event_names": "F",
"disable_notifications": "F",
"result_questions_url": null,
"num_finishers": 0,
"num_division_finishers": {
"1": 75,
"2": 75
},
"results_headers": {
"result_id": "Result Id",
"place": "Place",
"bib": "Bib",
"first_name": "First Name",
"last_name": "Last Name",
"gender": "Gender",
"city": "City",
"state": "State",
"country_code": "Country",
"clock_time": "Clock Time",
"chip_time": "Chip Time",
"pace": "Pace",
"age": "Age",
"age_percentage": "Age Percentage"
},
"results": [
{
"result_id": 423039,
"place": 1,
"bib": null,
"first_name": "Anonymous",
"last_name": "Participant",
"gender": "M",
"city": null,
"state": null,
"country_code": "US",
"clock_time": "NONE",
"chip_time": "",
"pace": null,
"age": 32,
"age_percentage": ""
}
],
"registration_ids": [
2652682
]
}
]
}
}
},
"securitySchemes": {
"apiKey": {
"type": "apiKey",
"in": "query",
"name": "api_key",
"description": "RunSignup API Key"
},
"apiSecret": {
"type": "apiKey",
"in": "query",
"name": "api_secret",
"description": "RunSignup API Secret"
}
}
},
"paths": {
"/race/{race_id}/results/get-results": {
"get": {
"tags": [
"Results"
],
"summary": "Get Event Results",
"description": "List all results for all result sets for an event.",
"operationId": "race_:race_id_results_get_results",
"parameters": [
{
"name": "race_id",
"in": "path",
"description": "Path parameter: race_id",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "api_key",
"in": "query",
"description": "API Key",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "api_secret",
"in": "query",
"description": "API Secret",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "rsu_api_key",
"in": "query",
"description": "API v2 key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "sp_api_key",
"in": "query",
"description": "Super partner API key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "X-RSU-API-SECRET",
"in": "header",
"description": "API v2 or super partner secret.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "Authorization Header. If using OAuth 2.0, fill this in with `Bearer <token>`.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "format",
"in": "query",
"description": "Format of response. The default if not sent is `xml`, but `json` is preferred.",
"required": false,
"schema": {
"type": "string",
"enum": [
"xml",
"json",
"csv"
],
"default": "xml"
}
},
{
"name": "event_id",
"in": "query",
"description": "ID of event.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "individual_result_set_id",
"in": "query",
"description": "ID of result set.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "include_total_finishers",
"in": "query",
"description": "Indicates whether or not to include total finishers in result set metadata. (Not supported for CSV)",
"required": false,
"schema": {
"type": "boolean",
"enum": [
"T",
"F"
],
"default": "F"
}
},
{
"name": "include_split_time_ms",
"in": "query",
"description": "Indicates whether or not to include milliseconds in split times.",
"required": false,
"schema": {
"type": "boolean",
"enum": [
"T",
"F"
],
"default": "F"
}
},
{
"name": "modified_after_timestamp",
"in": "query",
"description": "Get results modified after a given timestamp",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "supports_nb",
"in": "query",
"description": "Does integration support non-binary X gender?",
"required": false,
"schema": {
"type": "boolean",
"enum": [
"T",
"F"
],
"default": "F"
}
},
{
"name": "page",
"in": "query",
"description": "Page number to get.",
"required": false,
"schema": {
"type": "integer",
"default": "1"
}
},
{
"name": "results_per_page",
"in": "query",
"description": "Number of results per page.",
"required": false,
"schema": {
"type": "integer",
"default": "50"
}
},
{
"name": "first_name",
"in": "query",
"description": "Search for results by first name.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "last_name",
"in": "query",
"description": "Search for results by last name.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "gender",
"in": "query",
"description": "Search for results by gender.",
"required": false,
"schema": {
"type": "string",
"enum": [
"M",
"F"
]
}
},
{
"name": "bib_num",
"in": "query",
"description": "Search for results by bib number.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "registration_id",
"in": "query",
"description": "Search for results by registration ID.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "min_place",
"in": "query",
"description": "Search for results by minimum finishing place.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "max_place",
"in": "query",
"description": "Search for results by maximum finishing place.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "min_age",
"in": "query",
"description": "Search for results by minimum age.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "max_age",
"in": "query",
"description": "Search for results by maximum age.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "state",
"in": "query",
"description": "Search for results by state.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "country",
"in": "query",
"description": "Search for results by country.",
"required": false,
"schema": {
"type": "string",
"enum": [
"US",
"AD",
"AE",
"AF",
"AG",
"AI",
"AL",
"AM",
"AO",
"AQ",
"AR",
"AS",
"AT",
"AU",
"AW",
"AX",
"AZ",
"BA",
"BB",
"BD",
"BE",
"BF",
"BG",
"BH",
"BI",
"BJ",
"BL",
"BM",
"BN",
"BO",
"BQ",
"BR",
"BS",
"BT",
"BV",
"BW",
"BY",
"BZ",
"CA",
"CC",
"CD",
"CF",
"CG",
"CH",
"CI",
"CK",
"CL",
"CM",
"CN",
"CO",
"CR",
"CU",
"CV",
"CW",
"CX",
"CY",
"CZ",
"DE",
"DJ",
"DK",
"DM",
"DO",
"DZ",
"EC",
"EE",
"EG",
"EH",
"ER",
"ES",
"ET",
"FI",
"FJ",
"FK",
"FM",
"FO",
"FR",
"GA",
"GB",
"GD",
"GE",
"GF",
"GG",
"GH",
"GI",
"GL",
"GM",
"GN",
"GP",
"GQ",
"GR",
"GS",
"GT",
"GU",
"GW",
"GY",
"HK",
"HM",
"HN",
"HR",
"HT",
"HU",
"ID",
"IE",
"IL",
"IM",
"IN",
"IO",
"IQ",
"IR",
"IS",
"IT",
"JE",
"JM",
"JO",
"JP",
"KE",
"KG",
"KH",
"KI",
"KM",
"KN",
"KP",
"KR",
"KW",
"KY",
"KZ",
"LA",
"LB",
"LC",
"LI",
"LK",
"LR",
"LS",
"LT",
"LU",
"LV",
"LY",
"MA",
"MC",
"MD",
"ME",
"MF",
"MG",
"MH",
"MK",
"ML",
"MM",
"MN",
"MO",
"MP",
"MQ",
"MR",
"MS",
"MT",
"MU",
"MV",
"MW",
"MX",
"MY",
"MZ",
"NA",
"NC",
"NE",
"NF",
"NG",
"NI",
"NL",
"NO",
"NP",
"NR",
"NU",
"NZ",
"OM",
"PA",
"PE",
"PF",
"PG",
"PH",
"PK",
"PL",
"PM",
"PN",
"PR",
"PS",
"PT",
"PW",
"PY",
"QA",
"RE",
"RO",
"RS",
"RU",
"RW",
"SA",
"SB",
"SC",
"SD",
"SE",
"SG",
"SH",
"SI",
"SJ",
"SK",
"SL",
"SM",
"SN",
"SO",
"SR",
"SS",
"ST",
"SV",
"SX",
"SY",
"SZ",
"TC",
"TD",
"TF",
"TG",
"TH",
"TJ",
"TK",
"TL",
"TM",
"TN",
"TO",
"TR",
"TT",
"TV",
"TW",
"TZ",
"UA",
"UG",
"UM",
"UY",
"UZ",
"VA",
"VC",
"VE",
"VG",
"VI",
"VN",
"VU",
"WF",
"WS",
"XK",
"YE",
"YT",
"ZA",
"ZM",
"ZW"
]
}
}
],
"security": [
{
"apiKey": [],
"apiSecret": []
}
],
"responses": {
"200": {
"description": "Results Response - List of results for an event",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Race_raceIdResultsGetResultsGetResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BadRequestError"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedError"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ForbiddenError"
}
}
}
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundError"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServerError"
}
}
}
}
},
"x-permissions": [
"affiliates",
"partners",
"race_directors",
"timers"
]
}
}
}
}
