> For the complete documentation index, see [llms.txt](https://posetracker.gitbook.io/posetracker-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://posetracker.gitbook.io/posetracker-api/use-posetracker-on-real-time-camera-webcam/query-params-details/keypoints-optional.md).

# KEYPOINTS (optional)

Real-time endpoint:

```
https://app.posetracker.com/pose_tracker/tracking?token=YOUR_API_KEY&keypoints=true
```

Upload endpoint:

```
https://app.posetracker.com/pose_tracker/upload_tracking?token=YOUR_API_KEY&keypoints=true
```

* **Type:** `boolean`
* **Default:** `false`
* <mark style="color:$success;">**Plan: Only for Developer/Custom/Company only**</mark>

When enabled, PoseTracker emits `type: "keypoints"` messages.

***

### Payload shape (example)

```json
{
  "type": "keypoints",
  "timestampMs": 1730000000000,
  "frameId": 421,
  "keypoints": [
    { "name": "nose", "x": 0.51, "y": 0.12, "z": -0.02, "score": 0.99 },
    { "name": "left_shoulder", "x": 0.42, "y": 0.31, "z": -0.01, "score": 0.97 }
  ]
}
```

Coordinates are normalized (0..1) relative to the input frame unless otherwise specified by the endpoint implementation.

***

### Error behavior (Free plan)

```json
{
  "type": "error",
  "code": "developer_feature_not_allowed",
  "message": "You cannot use developer features on your current plan.",
  "details": { "blocked": ["keypoints"] }
}
```