Documentation / Guides

Getting started

Make your first GreyhoundAPI call in under five minutes: create a key, request today's racecards and read the response envelope.

Every request is a plain HTTPS GET against https://api.greyhoundapi.com/v1 with your key in a header. There is no OAuth dance and no request signing.

1. Get a key

Sign in and create a key from your dashboard. Live keys start gapi_live_; free sandbox keys start gapi_test_ and work against the same endpoints inside the sandbox data window.

2. Call the API

curl "https://api.greyhoundapi.com/v1/racecards/today?region=GB" \
  -H "X-API-Key: $GAPI_KEY"

3. Read the envelope

Every response has the same shape — meta for request bookkeeping and freshness, data for the payload:

{
  "meta": { "request_id": "req_8f2ac1", "data_as_of": "2026-07-08T13:05:12Z",
            "count": 25, "next_cursor": "eyJz..." },
  "data": [ … ]
}

data_as_of tells you how fresh the underlying pipeline was when the response was built — read Data freshness to use it properly. From here, Get a race is the endpoint most integrations are built around.