Skip to main content

Get compact AI context for one golf club

GET/v1/ai/context/clubs/{identifier}

Returns token-efficient, language-neutral club data. Use the stable UUID returned as id from search for this direct lookup; legacy slugs remain supported. Null values explicitly mean that the information is unknown. Tags: ai

Authentication​

Send the API key as a Bearer token in the Authorization header.

Parameters​

ParameterInTypeRequiredDescriptionConstraints
identifierpathstringYesPreferred stable club UUID or legacy unique slugmin length: 1; max length: 200

Example request​

curl --request GET \
--url 'https://api.eae.golf/v1/ai/context/clubs/b6bcc5e7-6c80-459e-98f8-afe5e2594ae2' \
--header 'Authorization: Bearer YOUR_API_KEY'

Responses​

200 · Default Response​

application/json​

FieldTypeRequiredDescriptionConstraints
dataobject<string, any>Yes
metaobjectYes
meta.apiVersionstringYesallowed: v1
meta.planstringYesallowed: fairway, tour
meta.accessStatusstringYesallowed: trial, active, suspended
meta.dataAccessstringYesallowed: core, extended
meta.trialEndsAt`stringnull`Yes
meta.catalogue`objectobject`Yes

Example

{
"data": {},
"meta": {
"apiVersion": "v1",
"plan": "fairway",
"accessStatus": "trial",
"dataAccess": "core",
"trialEndsAt": "2026-08-20T12:00:00Z",
"catalogue": {
"mode": "full"
}
}
}

401 · Default Response​

application/json​

FieldTypeRequiredDescriptionConstraints
statusCodeintegerYes
errorstringYes
codestringNo
messagestringYes
requestIdstringYes

Example

{
"statusCode": 0,
"error": "string",
"code": "trial_expired",
"message": "string",
"requestId": "req-7f3a2c"
}

404 · Default Response​

application/json​

FieldTypeRequiredDescriptionConstraints
statusCodeintegerYes
errorstringYes
codestringNo
messagestringYes
requestIdstringYes

Example

{
"statusCode": 0,
"error": "string",
"code": "trial_expired",
"message": "string",
"requestId": "req-7f3a2c"
}

429 · Default Response​

application/json​

FieldTypeRequiredDescriptionConstraints
statusCodeintegerYes
errorstringYes
codestringNo
messagestringYes
requestIdstringYes

Example

{
"statusCode": 0,
"error": "string",
"code": "trial_expired",
"message": "string",
"requestId": "req-7f3a2c"
}