Trials and plans

A trial is an access status, not a separate product tier. Choose Fairway or Tour based on the data required by the finished integration.

Plan	Trial access	Active access
Fairway	Core data, shared 500-club sample	Core data, full catalogue
Tour	Extended data, shared 500-club sample	Extended data, full catalogue

Trial limits

Both trials provide:

• 14 days of access
• The same geographically balanced, versioned 500-club sample
• 15 requests per minute
• 250 requests per day
• The AI Toolkit at the selected data level

Lifecycle

trial, active and suspended describe access status. fairway and tour describe the product and data level.

An expired trial returns a 403 response with the code trial_expired. A suspended client returns access_suspended.

One sample for every trial

All Fairway and Tour trial keys search the same fixed catalogue, currently global-trial-v2. The sample is selected from deliberately supported golf markets and representative places, then stored as explicit database membership. Minor territories do not displace major markets. It does not change between requests, clients or deployments.

Tour trials expose more fields for those clubs, but they do not expose more clubs than Fairway trials.

Trial data responses identify the effective catalogue:

{
  "meta": {
    "catalogue": {
      "mode": "sample",
      "sampleId": "global-trial-v2",
      "clubs": 500,
      "coverageUrl": "/v1/trial/coverage"
    }
  }
}

Active clients receive "catalogue": { "mode": "full" }.

Check what is in the sample

Before testing a place-specific workflow, inspect the sample coverage:

curl 'https://api.eae.golf/v1/trial/coverage' \
  --header 'Authorization: Bearer YOUR_TRIAL_API_KEY'

The response lists the countries and representative places available in the sample. It describes only the trial catalogue and does not reveal country statistics for the full dataset.

If a trial search returns no records, inspect meta.notice. The code trial_sample_no_match means the query found no match inside the sample. It does not prove that the full catalogue has no matching club.