Documentation / Race commentary

Completed write-ups

GET/v1/writeups/results

Available on Live Plus only

A Live key reaches the other 42 endpoints and receives 403 upgrade_required here. Compare plans

Full write-ups for races already run, with the preview, the report and a line on every runner, over the last hours or for one date.

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
hours query integer no Window size in hours, 1 to 168. Defaults to 24. Not with date.
date query date no Every race run on this date (YYYY-MM-DD), instead of a window of hours.
region query string no Filter by region code: GB, AU or IE.
cursor query string no Opaque pagination cursor from the previous response's meta.next_cursor.
limit query integer no Page size, 1–200. Defaults to 50.

Request

curl "https://api.greyhoundapi.com/v1/writeups/results?hours=24&region=GB" \
  -H "X-API-Key: $GAPI_KEY"
<?php
$ch = curl_init('https://api.greyhoundapi.com/v1/writeups/results?hours=24&region=GB');
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/writeups/results?hours=24&region=GB', {
  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/writeups/results?hours=24&region=GB', {
      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/writeups/results?hours=24&region=GB",
    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",
        "count": 1,
        "next_cursor": "eyJzIjoiMjAyNi0wNy0wOFQyMDo0NjowMFoifQ",
        "page": 1,
        "per_page": 50,
        "total": 1287,
        "total_pages": 26,
        "next_page": 2,
        "prev_page": null
    },
    "data": [
        {
            "race_id": 1245149,
            "region": "GB",
            "track": {
                "track_id": 1400000007,
                "name": "Central Park"
            },
            "race_number": 7,
            "scheduled_start": "2026-09-18T19:34:00Z",
            "status": "complete",
            "headline": "Silver Medal too good in D3 at 6/4",
            "preview": "Fawkham Sunrise has won 2 of its last 5 runs and has won twice at this track, while Frankton Flame has 1 win and 3 top-three finishes in its last 5 runs.",
            "report": "Silver Medal justified 6/4 favouritism, jumping very quickly from trap 3 and making all down the middle. Frankton Flame ran on to take second, 0.18 seconds behind.",
            "runners": [
                {
                    "trap": 3,
                    "dog_id": 650112,
                    "dog_name": "Silver Medal",
                    "position": 1,
                    "line": "Silver Medal won at 6/4, jumping very quickly from the traps and making all."
                }
            ],
            "written_at": "2026-09-21T10:52:14+00:00"
        }
    ]
}

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/writeups/results

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.

Related in Race commentary