Fit a driver, fairway wood, hybrid, irons or wedges and return specs plus club recommendations

post/v1/fitting/analyze

Request

  • Base URL: https://api.eldrick.com
  • URL: https://api.eldrick.com/v1/fitting/analyze
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.eldrick.com/oauth/authorize, token URL https://api.eldrick.com/oauth/token, scopes: fittings:create)

Query parameters

detail'full'

Set to full to include detailed analysis text and reasoning.

Headers

Idempotency-Keystring

Unique key for safe retries. Replaying the same request returns the original fitting; changing the request returns 409.

X-ELDRICK-Platformstring

Optional: the AI platform or app making the call (e.g. chatgpt, claude, gemini, copilot, perplexity, lechat), for usage reporting. OAuth connections are attributed automatically.

X-ELDRICK-Clientstring

Optional: your client or agent name, for usage reporting.

Request body

clubType'driver' | 'fairway' | 'hybrid' | 'iron' | 'wedge' required

driver; fairway (fairway wood); hybrid; iron (an iron set, fitted from the 7-iron); wedge. swingMetrics are measured with that club: driver numbers for driver and fairway (or 3-wood numbers with clubDetails.fairwaySpeedSource=three_wood), the hybrid's own numbers, 7-iron numbers for irons, the wedge's own numbers for wedges.

Example request

{
  "golferWords": {
    "miss": "slice",
    "swingSpeed": "106-108 mph"
  }
}

Response

Fitting specs and product recommendations

successunknown
fittingIdstring
requestIdstring
clubType'driver' | 'fairway' | 'hybrid' | 'iron' | 'wedge'
labUrlstring uri nullable

15-minute Lab share URL for driver and iron fittings. Null for other clubs or when Lab handoff is not configured.

labExpiresAtstring date-time nullable
woodFitobject

Fairway and hybrid only: club, designation, recommended loft and label, gapping note, driver and wood shaft weight bands, weight step (g) and length.

wedgeFitobject

Wedge only: recommended and target loft, bounce (label, bracket, target, min, max, range, note), the recommended wedge set makeups with per-wedge loft and bounce, gap/sand wedge ball-flight flags, and wedgeHit (the wedge the numbers were read for: PW, GW, SW, LW, or null).

Example response

{
  "meta": {
    "apiVersion": "v1",
    "engineVersion": "eldrick-fit-legacy-deterministic-v1",
    "rulesetRevision": "core@3000454"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.