Loki Docs
Tools › Workouts › Get a personal record

Get a personal record

get_personal_recordReads
What it does
Reads only. Changes nothing.
Permission
Workouts, read workouts:read

What your assistant is told

Best performance for one exercise across the user's whole logged history: heaviest set and best estimated 1-rep-max (Epley), counted over working sets only — warm-up and drop sets never set a record, though they do count towards timesPerformed/totalSets. Exercise referenced by exercise. Pass clientHandle to read a coached client's PR. **Both bests are ranked by loadKg — what the set MOVED — not by weightKg, what was typed in.** They differ wherever loadMode is not "weight": on a pull-up with a belt weightKg is the belt (+20) and loadKg is the body plus the belt; on the same pull-up assisted, weightKg is the assistance as a NEGATIVE (-20) and loadKg is what was left of the body. One exercise spans both, so the bests may be set with a belt and compared against assisted sets on the way up (catalog.md D20). Quote loadKg when you say how much they lifted, and weightKg when you tell them what to set the machine to. With a bodyweight-based loadMode and bodyweightKg: null the user has never recorded a weigh-in, so the bests are empty even though the sets exist — say that, and don't guess a bodyweight.

Parameters

  • exercisetext, requiredThe exercise, as a catalog slug (e.g. "barbell-full-squat") or the numeric id of one of the user's own.
  • clientHandletext, optionalOptional client_handle from list_clients to run this tool against a coached client's data instead of your own. Omit (or pass null) for your own data — the legacy default.