FormFav LogoFormFav
    GET
    /v1/stats/jockey/{name}
    Pro

    Jockey Stats

    Returns career statistics for a jockey, including overall win/place rates and per-track breakdowns.

    Parameters

    namestring
    required
    Jockey name (path parameter). Case-insensitive. Use URL encoding for names with spaces (e.g. J.%20McDonald).
    race_codestring
    optional
    Default: gallops
    Race type filter.
    min_startsinteger
    optional
    Default: 5
    Minimum starts at a track to include in trackStats. Range: 1-100.
    windowinteger
    optional
    Optional rolling window in days (14–365). When provided, a recentStats object is included with stats computed only from races within the window.

    Code Examples

    javascript
    const response = await fetch(
      'https://api.formfav.com/v1/stats/jockey/J.%20McDonald?' +
      new URLSearchParams({ race_code: 'gallops', window: '90' }),
      {
        headers: { 'X-API-Key': 'your_api_key_here' }
      }
    );
    
    const data = await response.json();

    Response Fields

    jockeyNamestring
    Canonical jockey name
    raceTypestring
    Race type filter applied
    totalStartsinteger
    Total career starts
    totalWinsinteger
    Total career wins
    overallWinRatenumber
    Career win rate (0-1)
    overallPlaceRatenumber
    Career place rate (0-1)
    trackStatsarray
    Per-track breakdown
    trackStats[].trackstring
    Track name
    trackStats[].startsinteger
    Starts at this track
    trackStats[].winsinteger
    Wins at this track
    trackStats[].winRatenumber
    Win rate at this track
    trackStats[].placeRatenumber
    Place rate at this track
    conditionStatsarray
    Performance by track condition
    conditionStats[].conditionstring
    Track condition (e.g. Good, Soft, Heavy)
    conditionStats[].totalStartsinteger
    Starts in this condition
    conditionStats[].winsinteger
    Wins in this condition
    conditionStats[].winRatenumber
    Win rate
    conditionStats[].placeRatenumber
    Place rate
    bestConditionstring | null
    Condition with highest win rate (minimum 20 starts)
    worstConditionstring | null
    Condition with lowest win rate (minimum 20 starts)
    isAmbiguousboolean
    True if name could match multiple jockeys
    recentStatsobject | null
    Recent-window stats (only when window param provided)
    recentStats.windowDaysinteger
    Window size in days
    recentStats.totalStartsinteger
    Starts in window
    recentStats.overallWinRatenumber
    Win rate in window
    recentStats.overallPlaceRatenumber
    Place rate in window
    recentStats.trackStatsarray
    Per-track breakdown in window
    recentStats.conditionStatsarray
    Per-condition breakdown in window

    Example Response

    200
    Response
    json
    {
      "jockeyName": "J. McDonald",
      "raceType": "gallops",
      "totalStarts": 1245,
      "totalWins": 198,
      "overallWinRate": 0.159,
      "overallPlaceRate": 0.482,
      "trackStats": [
        {
          "track": "Randwick",
          "starts": 312,
          "wins": 62,
          "winRate": 0.199,
          "placeRate": 0.526
        },
        {
          "track": "Flemington",
          "starts": 87,
          "wins": 15,
          "winRate": 0.172,
          "placeRate": 0.471
        }
      ]
    }