---
title: "Complete cable encoder calibration with measured distance"
method: POST
path: "/api/v1/reel/calibration/finish"
tags: ["v1", "cable-calibration"]
---

# Complete cable encoder calibration with measured distance

`POST /api/v1/reel/calibration/finish`

Complete calibration using the measured cable distance to calculate the new calibration factor.

Calculates the calibration factor (pulses per meter) by dividing encoder position change by the actual measured cable distance. The new factor is applied immediately and saved to system configuration. Requires the exact distance in meters that the cable was extended during calibration.

## Request body

- FinishCalibrationRequest — Request data for completing cable encoder calibration with measured distance.
  - `pulled_cable_length` number, required — Exact physical distance the cable was extended during calibration in meters. This value determines the accuracy of all future position calculations. Measure to nearest centimeter for optimal accuracy. Typical values: 1 meter (minimum), 5 meters (standard), 10 meters (long/high precision).

## Response `200`

Calibration completion results with new calibration factor

- FinishCalibrationResponse — Response for completing cable encoder calibration with calculated factor. Calculates and applies new calibration factor based on measured cable extension. System returns to normal operations with improved position accuracy.
  - `action` string, required — The action that was requested or performed by the endpoint
  - `error` boolean, required — Indicates whether the operation encountered an error
  - `error_msgs` string[] — List of error messages if the operation failed
  - `result` FinishCalibrationResult, required — Result data for calibration completion including new calibration factor.
    - `calibrating` boolean, required — Current calibration status of the cable encoder system. Indicates whether the system is actively in calibration mode. Monitor this status via heartbeat `is_cable_counter_calibrating` field. Emergency stop remains functional during calibration.
    - `new_factor` number, required — Newly calculated calibration factor in pulses per meter. Calculated as: encoder position change ÷ measured cable distance. Used for all future position calculations and automatically saved to system configuration.

## Other responses

- `401` — Could not validate credentials
- `403` — Setup required before using this endpoint
- `422` — Invalid calibration measurement data
- `500` — Internal server error

---

[API](https://skmtc.net/reach-systems-tech/apis/reelapi-v1.md) · [All operations](https://skmtc.net/reach-systems-tech/apis/reelapi-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reach-systems-tech/reelapi-v1/revisions/1dd366a9c6a3/schema)