Documentation

Keely for developers

Me

Who connected, what they allowed, and their profile and band when the scope is there.

Updated

On this page
  1. GET /v1/me

GET /v1/me

Scope
none for person_id, scopes and app; profile for profile and band

person_id is the account’s id, stable for its life: use it as your key for the person. The API never gives their email.

profile and band are null when nothing is recorded (a person who hasn’t paired a band yet), and left out, with "not_allowed": ["profile"], when your app doesn’t have the scope. resting_hr_bpm and max_hr_bpm are the person’s own settings, null unless they entered them; the measured ones are in each night and in the normals.

Response
{
  "person_id": "0b8f1a52-7e3c-4d0a-9c1b-2e6f3a4b5c6d",
  "scopes": ["profile", "nights", "days", "workouts"],
  "app": { "name": "Metrica", "status": "approved" },
  "journal_shared": false,
  "profile": {
    "birth_year": 1990, "sex": "male", "height_cm": 180, "weight_kg": 76,
    "sleep_goal_minutes": 470, "resting_hr_bpm": null, "max_hr_bpm": null
  },
  "band": {
    "name": "Polar Loop C0680226", "model": "Polar Loop", "firmware": "6.2.26",
    "paired_at": "2026-09-17T06:20:00Z", "last_sync_at": "2026-09-27T15:20:00Z"
  },
  "as_of": "2026-09-27T15:20:00Z",
  "methodology": "https://meetkeely.com/methodology"
}