---
title: "Get cable position"
method: GET
path: "/api/v1/reel/encoder/count"
tags: ["v1", "cable-position"]
---

# Get cable position

`GET /api/v1/reel/encoder/count`

Retrieves the current cable position from the encoder in meters.

Returns the current encoder reading converted to meters using the active calibration factor. This the cable position is also returned as part of the heartbeat data.

## Response `200`

Successful Response

- GetCablePositionResponse — Response for cable encoder position retrieval operations. Returns the current cable position from the encoder in meters. Provides real-time cable length information for monitoring and control purposes.
  - `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` GetCablePositionResult, required — Result data for cable position retrieval operations.
    - `cable_position` number, required — Current cable encoder position in meters. Real-time position reading from the cable encoder, converted to meters using the active calibration factor. Position is relative to the last established zero point.

## Other responses

- `401` — Could not validate credentials
- `403` — Setup required before using this endpoint
- `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/versions/1dd366a9c6a3/schema)