---
title: "GET /cameras/{cameraId}/ptz/position"
method: GET
path: "/cameras/{cameraId}/ptz/position"
tags: ["PTZ"]
---

# GET /cameras/{cameraId}/ptz/position

`GET /cameras/{cameraId}/ptz/position`

This endpoint returns the current position of the camera. The response includes the pan, tilt, and zoom values of the camera. If the camera does not support pan or  tilt or zoom, the corresponding value will not be present in the response.

## Response `200`

Current PTZ position of camera.

- ApiPtzPosition — The ptz coordinates of the camera in a space defined as pan:(-1,1), tilt:(-1,1), zoom:(0,1).
  - `x` number, double — Pan coordinate given as value between -1(max left) and 1(max right).
  - `y` number, double — Tilt coordinate given as value between -1(max down) and 1(max up).
  - `z` number, double — Zoom coordinate given as value between 0(fully zoomed out) and 1(fully zoomed in).

## Other responses

- `400` — The supplied object is invalid. Error detail will contain the validation error.
- `401` — You are not authenticated. Please authenticate and try again.
- `403` — You have no permission to access the specified resource.
- `404` — Referenced resource could not be found.
- `409` — There was a conflict while trying to perform your request. See error details for more information.
- `500` — Something went wrong in the server. Please try again.

---

[API](https://skmtc.net/eagleeyenetworks/apis/devices.md) · [All operations](https://skmtc.net/eagleeyenetworks/apis/devices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eagleeyenetworks/devices/versions/df57313de545/schema)