v7
OpenAPI 3.1.02026-08-0358124623.5 KBHorses
Basic Plan
Standard Plan
Pro Plan
Horse Distance Time Analysis
<h4>Get horse statistics by race distance, with breakdowns of times.</h4><table><tbody><tr><td><b>Min. Required Plan</b></td><td>Basic</td></tr><tr><td><b>Rate Limit</b></td><td>5 requests per second</td></tr></tbody></table>get/v1/horses/{horse_id}/analysis/distance-times
Path parameters
horse_idstring required
Query parameters
start_datestring nullable
<p>Query from date with format YYYY-MM-DD, e.g. <code>2020-01-01</code></p>
<p>Query from date with format YYYY-MM-DD, e.g. <code>2020-01-01</code></p>
end_datestring nullable
<p>Query to date with format YYYY-MM-DD, e.g. <code>2020-01-01</code></p>
<p>Query to date with format YYYY-MM-DD, e.g. <code>2020-01-01</code></p>
regionstring[] nullable
<p>Query by region codes. Get the full list <a href='https://api.theracingapi.com/documentation#tag/Courses/operation/list_regions_v1_courses_regions_get'>here</a>.</p><p>Note: If the course query parameter is specified, this will be ignored.</p>
<p>Query by region codes. Get the full list <a href='https://api.theracingapi.com/documentation#tag/Courses/operation/list_regions_v1_courses_regions_get'>here</a>.</p><p>Note: If the course query parameter is specified, this will be ignored.</p>
coursestring[] nullable
Query by course ids. Get the full list <a href='https://api.theracingapi.com/documentation#tag/Courses/operation/list_courses_v1_courses_get'>here</a>.
Query by course ids. Get the full list <a href='https://api.theracingapi.com/documentation#tag/Courses/operation/list_courses_v1_courses_get'>here</a>.
typestring[] nullable
<p>Query by race type</p><p>Options: <code>chase</code>, <code>flat</code>, <code>hurdle</code>, <code>nh_flat</code></p>
<p>Query by race type</p><p>Options: <code>chase</code>, <code>flat</code>, <code>hurdle</code>, <code>nh_flat</code></p>
goingstring[] nullable
<p>Query by going</p><p>Options: <code>fast</code>, <code>firm</code>, <code>good</code>, <code>good_to_firm</code>, <code>good_to_soft</code>, <code>good_to_yielding</code>, <code>hard</code>, <code>heavy</code>, <code>holding</code>, <code>muddy</code>, <code>sloppy</code>, <code>slow</code>, <code>soft</code>, <code>soft_to_heavy</code>, <code>standard</code>, <code>standard_to_fast</code>, <code>standard_to_slow</code>, <code>very_soft</code>, <code>yielding</code>, <code>yielding_to_soft</code></p>
<p>Query by going</p><p>Options: <code>fast</code>, <code>firm</code>, <code>good</code>, <code>good_to_firm</code>, <code>good_to_soft</code>, <code>good_to_yielding</code>, <code>hard</code>, <code>heavy</code>, <code>holding</code>, <code>muddy</code>, <code>sloppy</code>, <code>slow</code>, <code>soft</code>, <code>soft_to_heavy</code>, <code>standard</code>, <code>standard_to_fast</code>, <code>standard_to_slow</code>, <code>very_soft</code>, <code>yielding</code>, <code>yielding_to_soft</code></p>
race_classstring[] nullable
<p>Query by class</p><p>Options: <code>class_1</code>, <code>class_2</code>, <code>class_3</code>, <code>class_4</code>, <code>class_5</code>, <code>class_6</code>, <code>class_7</code></p>
<p>Query by class</p><p>Options: <code>class_1</code>, <code>class_2</code>, <code>class_3</code>, <code>class_4</code>, <code>class_5</code>, <code>class_6</code>, <code>class_7</code></p>
min_distance_yinteger nullable
<p>Query by minimum race distance (yards)</p>
<p>Query by minimum race distance (yards)</p>
max_distance_yinteger nullable
<p>Query by maximum race distance (yards)</p>
<p>Query by maximum race distance (yards)</p>
age_bandstring[] nullable
<p>Query by age band</p><p>Options: <code>10yo+</code>, <code>2-3yo</code>, <code>2yo</code>, <code>2yo+</code>, <code>3-4yo</code>, <code>3-5yo</code>, <code>3-6yo</code>, <code>3yo</code>, <code>3yo+</code>, <code>4-5yo</code>, <code>4-6yo</code>, <code>4-7yo</code>, <code>4-8yo</code>, <code>4yo</code>, <code>4yo+</code>, <code>5-6yo</code>, <code>5-7yo</code>, <code>5-8yo</code>, <code>5yo</code>, <code>5yo+</code>, <code>6-7yo</code>, <code>6yo</code>, <code>6yo+</code>, <code>7yo+</code>, <code>8yo+</code>, <code>9yo+</code></p>
<p>Query by age band</p><p>Options: <code>10yo+</code>, <code>2-3yo</code>, <code>2yo</code>, <code>2yo+</code>, <code>3-4yo</code>, <code>3-5yo</code>, <code>3-6yo</code>, <code>3yo</code>, <code>3yo+</code>, <code>4-5yo</code>, <code>4-6yo</code>, <code>4-7yo</code>, <code>4-8yo</code>, <code>4yo</code>, <code>4yo+</code>, <code>5-6yo</code>, <code>5-7yo</code>, <code>5-8yo</code>, <code>5yo</code>, <code>5yo+</code>, <code>6-7yo</code>, <code>6yo</code>, <code>6yo+</code>, <code>7yo+</code>, <code>8yo+</code>, <code>9yo+</code></p>
sex_restrictionstring[] nullable
<p>Query by sex restriction</p><p>Options: <code>c&f</code>, <code>c&g</code>, <code>f</code>, <code>f&m</code>, <code>m</code>, <code>m&g</code></p>
<p>Query by sex restriction</p><p>Options: <code>c&f</code>, <code>c&g</code>, <code>f</code>, <code>f&m</code>, <code>m</code>, <code>m&g</code></p>
Response
Successful Response
Example response
{
"dam": "Green Vision (IRE)",
"dam_id": "dam_5639200",
"damsire": "Green Desert",
"damsire_id": "dsi_2126159",
"distances": [
{
"1_pl": -5,
"1st": 1,
"2nd": 2,
"3rd": 0,
"4th": 0,
"a/e": 0.5,
"dist": "6f",
"dist_f": "6f",
"dist_m": "1225",
"dist_y": "1340",
"runs": 11,
"times": [
{
"course": "Chelmsford (AW)",
"date": "2022-04-28",
"going": "Standard",
"position": "7",
"region": "GB",
"time": "1:11.94"
}
],
"win_%": 0.09
}
],
"horse": "Princess Shabnam (IRE)",
"id": "hrs_25481624",
"query": [
[
"horse_id",
"hrs_25481624"
]
],
"sire": "Gregorian (IRE)",
"sire_id": "sir_5494055",
"total_runs": 16
}