---
title: "Retrieve a prior fitting and its evidence"
method: GET
path: "/v1/fittings/{fittingId}"
---

# Retrieve a prior fitting and its evidence

`GET /v1/fittings/{fittingId}`

## Request

- Base URL: `https://api.eldrick.com`
- URL: `https://api.eldrick.com/v1/fittings/{fittingId}`
- 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:read`)

Returns a fitting previously created by the authenticated API account, including its saved input, output, and engine provenance.

## Path parameters

- `fittingId` string, required

## Response `200`

Stored fitting record

- StoredFittingResponse
  - `success` unknown, required
  - `fittingId` string, required
  - `clubType` string, required
  - `status` string, required
  - `input` FittingRequest, required
    - `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.
    - `golfer` object, required
      - `handedness` 'left' | 'right', required
      - `handicap` union
        - number
        - '25+'
      - `heightFeet` integer
      - `heightInches` integer
      - `weight` integer
      - `wristToFloor` number: Optional. Without it lengths stay standard.
      - `gender` 'male' | 'female': Optional, only when the golfer said. female applies the women's rules (Ladies flex, women's lengths and heads); omitted = fitted on the men's tables.
      - `age` integer: Optional, only when the golfer said. Juniors (12 and under) get the junior rules.
      - `averageScore` number: Optional: the golfer's average 18-hole score, for a golfer with no handicap. Send handicap instead when they have one.
    - `swingMetrics` object, required: Provide swingSpeed or ballSpeed.
      - `swingSpeed` number
      - `ballSpeed` number
      - `launchAngle` number
      - `attackAngle` number
      - `clubPath` number
      - `faceAngle` number
      - `spinRate` number
      - `carryDistance` number
      - `totalDistance` number: Driver total distance (carry plus roll) in yards
      - `peakHeight` number
      - `landingAngle` number
      - `strikePattern` 'heel' | 'toe' | 'center' | 'mix'
      - `missPattern` 'fade' | 'hook' | 'straight' | 'both'
      - `missSize` 'slight' | 'moderate' | 'large': Optional, after missPattern: how big the usual miss is (slight, moderate or large). A driver's stated miss moves the adjustable weight to Draw or Fade Bias, and earns a Draw Bias head, only when it is moderate or large; slight or omitted keeps Standard and no Draw Bias head. Measured club path and face angle still decide (Moderate or Large rating moves the weight).
      - `ballFlight` 'low' | 'normal' | 'high': Optional, for golfers without a launch monitor: how their ball flight usually looks (low = too low, normal = good, high = too high). Driver, and fairway with driver numbers: used as a launch angle of 9° / 13° / 17°, the mapping ELDRICK's fitting form uses. Fairway with 3-wood numbers, hybrid, iron and wedge: passed to the fitting as the golfer's description; no launch number is assumed. A measured launchAngle takes precedence.
    - `currentEquipment` object
      - `brand` string
      - `model` string: The golfer's current club model: free text, or the value of an option from GET /v1/catalog/club-models (for example "P790 (2019)", "GTS3 (current model)"). A model name sold in several generations without its year ("P790") or a model ELDRICK cannot date gets no age in the write-up.
      - `shaftModel` string
      - `shaftLaunchProfile` 'Low' | 'Mid-Low' | 'Mid' | 'Mid-High' | 'High': Launch profile of the golfer's current shaft (for example the catalog shaft they picked from GET /v1/catalog). Launch-profile rules start from it. Omitted: unknown, treated as Mid, and the result lists the current_shaft_launch_unknown data gap.
      - `loft` number: Driver/iron: the current club's loft. Fairway (12-23), hybrid (17-28) and wedge (44-62): the loft of the club being fitted; a wedge defaults to 52.
      - `length` number
      - `shaftWeight` integer
    - `preferences` object
      - `tempo` 'slow' | 'medium' | 'fast'
      - `transition` 'smooth' | 'medium' | 'quick'
      - `shaftType` 'steel' | 'graphite'
      - `release` string
      - `feelBalance` string
      - `goals` string
      - `fixes` string[]: Optional: the ball-flight issues the golfer wants fixed (eldrick.com's chips). less-slices earns the Draw Bias weight and less-hooks the Fade Bias weight even without a missPattern.
    - `clubDetails` object: Fairway, hybrid and wedge only (ignored for driver and iron). The same extra inputs eldrick.com uses for these clubs.
      - `fairwayDesignation` '3-wood' | '5-wood' | '7-wood': Fairway: which wood is being fitted (sets the stock length).
      - `fairwaySpeedSource` 'driver' | 'three_wood': Fairway: whether swingMetrics are driver numbers (default) or 3-wood numbers (converted to driver-equivalent before fitting).
      - `driverSpeed` number: Fairway/hybrid: a measured driver speed (mph). Sets the driver shaft baseline the wood weight steps up from.
      - `sevenIronSpeed` number: Wedge: a measured 7-iron speed (mph). Wedge shaft rows are 7-iron calibrated; without it the wedge speed ÷ 0.885 is used.
      - `pwLoft` number: Wedge: pitching wedge loft. The recommended wedge set gaps from it.
      - `lobWedgeFullSwing` 'yes' | 'no' | 'unsure': Wedge: does the golfer often hit the lob wedge full? Sets the SW→LW gap.
      - `wedgeHit` 'PW' | 'GW' | 'AW' | 'UW' | 'SW' | 'LW': Wedge: which wedge the swingMetrics were hit with (AW/UW = gap wedge). The numbers are read for that club: GW or SW ball-flight table (none for PW/LW), stock length (steel GW 35.5", SW 35.25", LW 35"), SW/LW swing weight rule. Without currentEquipment.loft it sets the loft (PW 46°, GW 50°, SW 56°, LW 60°). Omitted: the loft decides. Wedge spin is graded up to 11,000 rpm.
      - `ironFittingId` string: Wedge: a completed iron fitting from this account. Its shaft weight, flex, swing weight, launch and 7-iron speed carry into the wedges.
      - `ironShaft` object: Wedge, without ironFittingId: the golfer's current iron shaft.
        - `flex` 'Ladies' | 'Senior' | 'Regular' | 'Stiff' | 'Stiff+' | 'Extra Stiff'
        - `weightGrams` number
        - `material` 'Steel' | 'Graphite'
        - `launchProfile` 'Low' | 'Mid-Low' | 'Mid' | 'Mid-High' | 'High'
    - `golferWords` object: Optional, display only. The golfer's own short words for inputs the fitting takes as enums and numbers, shown on the fitting instead of them ("Slice miss", "From 106-108 mph"). Each value: at most 24 characters of letters, digits, spaces and - / . °, no links, handles or emails; swingSpeed and carry need a digit, miss and ballFlight a letter. A value that breaks a rule is dropped without an error. Never read by the fitting engine or the matcher: still send swingMetrics.missPattern, swingSpeed, carryDistance and ballFlight.
      - `miss` string
      - `swingSpeed` string
      - `carry` string
      - `ballFlight` string
  - `output` object, nullable
  - `processingTimeMs` integer, nullable
  - `createdAt` string, date-time, required

## Other responses

- `401`: Unauthorized
- `404`: Fitting not found

---

[API](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api.md) · [All operations](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/revisions/9469c1821a83?raw)