👨‍💻Query Params details

This endpoint runs real-time pose estimation and exercise tracking using the PoseTracker engine.

Canonical endpoint

GET https://app.posetracker.com/pose_tracker/tracking?token=...&exercise=...

---

Minimum required URL (real-time)

https://app.posetracker.com/pose_tracker/tracking?token=YOUR_API_KEY&exercise=squat

---

Query parameters

The full parameter reference is maintained here:

• Shared query parameters (Tracking + Upload Tracking)

Important real-time parameters

• token (required)

• exercise (required)

• placement, postureBox, placementCountdownSeconds (recommended)

• Optional: minGrade (repetition exercises only)

---

minGrade (optional, repetition exercises only)

Use minGrade if you want PoseTracker to only count “valid” reps.

Example:

https://app.posetracker.com/pose_tracker/tracking?token=YOUR_API_KEY&exercise=squat&minGrade=B

• Counts only reps graded A or B

• Does not count reps graded C, D, or F

• Ignored for duration and custom exercises

The grade is sent inside the counter event as counter.form_score.grade.

---

Typical realtime message flow

1. initialization

2. posture (placement) until ready + optional countdown

3. counter (on each counted rep)

   • includes form_score for the rep that was just counted

4. optional outputs (plan-gated): progression, recommendations, keypoints, angles

5. error at any time

See full payloads:

• Tracking Endpoint Message to handle