---
title: "Calculate fit guidance"
method: POST
path: "/api/v1/tools/get_fit_guidance"
tags: ["Agent tools"]
---

# Calculate fit guidance

`POST /api/v1/tools/get_fit_guidance`

## Request

- Base URL: `https://parts.skoia.me`
- URL: `https://parts.skoia.me/api/v1/tools/get_fit_guidance`
- Auth: none declared

Calculates deterministic manufacturing compensation and returns an explicit physical-test warning.

## Request body

- object
  - `nominalMm` number, required
  - `fitType` 'PRESS' | 'TIGHT' | 'SLIDING' | 'LOOSE', required
  - `measurementBasis` 'NOMINAL' | 'INTERNAL' | 'EXTERNAL'
  - `gender` 'MALE' | 'FEMALE' | 'NEUTRAL'
  - `material` string
  - `process` string
  - `userCalibrationMm` number

## Response `200`

Structured tool result

- object
  - `schemaVersion` unknown, required
  - `tool` string, required
  - `requestId` string, required
  - `status` 'OK' | 'NEEDS_INPUT' | 'BLOCKED' | 'UNAVAILABLE', required
  - `facts` object[], required
  - `confidence` object, required
    - `score` number, nullable, required
    - `level` 'HIGH' | 'MEDIUM' | 'LOW' | 'UNKNOWN', required
    - `reason` string, nullable
  - `provenance` object[], required
    - `type` string, required
    - `source` string, nullable
    - `retrieved_at` string, nullable
    - `verification_status` string, nullable
  - `warnings` string[], required
  - `data` object, required

## Other responses

- `4XX`: Machine-readable client error
- `5XX`: Machine-readable transient or provider error

---

[API](https://skmtc.dev/skoia/apis/skoia-parts-agent-api.md) · [All operations](https://skmtc.dev/skoia/apis/skoia-parts-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skoia/apis/skoia-parts-agent-api/revisions/cdad8c14db92?raw)