Documentation / Weather

Weather by Race ID

GET/v1/races/{race_id}/weather

Available on Live Live Plus

Temperature, wind, gusts and rain at the track for the hour the race went off, with the rain and wind in the hours before it.

Authenticate with your key in the X-API-Key header, or ?key= if your tool cannot set one — see Authentication. Works with sandbox keys inside the sandbox data window.

Parameters

NameInTypeRequiredDescription
race_id path integer yes The race identifier.

Request

curl "https://api.greyhoundapi.com/v1/races/3959843903/weather" \
  -H "X-API-Key: $GAPI_KEY"
<?php
$ch = curl_init('https://api.greyhoundapi.com/v1/races/3959843903/weather');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: ' . getenv('GAPI_KEY')],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response['data']);
const res = await fetch('https://api.greyhoundapi.com/v1/races/3959843903/weather', {
  headers: { 'X-API-Key': process.env.GAPI_KEY }
});
if (!res.ok) throw new Error(`GreyhoundAPI ${res.status}`);
const { meta, data } = await res.json();
console.log(meta.data_as_of, data);
import { useEffect, useState } from 'react';

export default function Example() {
  const [data, setData] = useState(null);

  useEffect(() => {
    fetch('https://api.greyhoundapi.com/v1/races/3959843903/weather', {
      headers: { 'X-API-Key': import.meta.env.VITE_GAPI_KEY }
    })
      .then((r) => r.json())
      .then((body) => setData(body.data));
  }, []);

  if (!data) return <p>Loading…</p>;
  return <pre>{JSON.stringify(data, null, 2)}</pre>;
}

Browser code exposes whatever key it ships with — use a sandbox key for prototypes and proxy live keys through your own server in production.

import os
import requests

r = requests.get(
    "https://api.greyhoundapi.com/v1/races/3959843903/weather",
    headers={"X-API-Key": os.environ["GAPI_KEY"]},
    timeout=10,
)
r.raise_for_status()
body = r.json()
print(body["meta"]["data_as_of"], body["data"])

Response

200 OKapplication/json
{
    "meta": {
        "request_id": "req_8f2ac1",
        "data_as_of": "2026-07-08T13:05:12Z"
    },
    "data": {
        "race_id": 1229082445,
        "region": "GB",
        "track": {
            "track_id": 1400000014,
            "name": "Romford",
            "latitude": 51.57538,
            "longitude": 0.18269
        },
        "matched_on": "official_off",
        "weather": {
            "hour_utc": "2026-09-17T19:00:00Z",
            "temp_c": 15.2,
            "humidity_pct": 81,
            "wind_kph": 19.5,
            "gust_kph": 42.8,
            "wind_from": "W",
            "wind_deg": 271,
            "precip_mm": 0.3,
            "conditions": "light drizzle",
            "before_race": {
                "rain_6h_mm": 1.6,
                "rain_24h_mm": 2,
                "wind_avg_6h_kph": 21.4
            },
            "source": "archive"
        },
        "weather_absent": null
    }
}

Run it live

A real request from your browser straight to api.greyhoundapi.com with your own key — nothing is proxied or logged by this page.

GET/v1/races/{race_id}/weather

Held in this tab only, sent only to the API host. No key yet? Create a free sandbox key — it runs every endpoint against the sandbox data window.