curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/milestones/{milestone_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/milestones/{milestone_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/patient/milestones/{milestone_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0190f5e1-2a3b-7c4d-9e5f-6a7b8c9d0e1f",
"code": "weight_loss_5_pct",
"category": "weight",
"title": "5% of your starting weight",
"message": "You're down 5.1 kg since your first weigh-in. Keep the protein up to protect your muscle.",
"achieved_at": "2026-10-25T08:05:00Z",
"stats": {
"start_weight_kg": 100.7,
"current_weight_kg": 95.6,
"change_pct": -5.1
}
}Get a milestone
The milestone with the patient’s own numbers, for a celebration screen after patient.milestone_reached.
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/milestones/{milestone_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/milestones/{milestone_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/patient/milestones/{milestone_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0190f5e1-2a3b-7c4d-9e5f-6a7b8c9d0e1f",
"code": "weight_loss_5_pct",
"category": "weight",
"title": "5% of your starting weight",
"message": "You're down 5.1 kg since your first weigh-in. Keep the protein up to protect your muscle.",
"achieved_at": "2026-10-25T08:05:00Z",
"stats": {
"start_weight_kg": 100.7,
"current_weight_kg": 95.6,
"change_pct": -5.1
}
}Authorizations
A 15-minute token bound to one patient and one enrollment, issued by POST /v1/oauth/token with the
token-exchange grant. Treat it as opaque. When it expires, exchange a fresh assertion; there is no refresh token.
Path Parameters
Response
The milestone.
"0190f5e1-2a3b-7c4d-9e5f-6a7b8c9d0e1f"
What the patient reached. New codes may be added; show a generic celebration for a code you don't know.
| Code | Reached when |
|---|---|
first_meal_logged | The first meal is logged |
logging_streak_7, logging_streak_30 | Something is logged 7 or 30 days in a row |
protein_target_days_7, protein_target_days_30 | 7 or 30 days at 80% or more of the protein target |
workouts_10, workouts_50 | 10 or 50 workouts logged |
injections_on_time_4, injections_on_time_12 | 4 or 12 doses in a row logged on their day |
week_4_completed, week_12_completed | 4 or 12 weeks since enrollment |
weight_loss_5_pct, weight_loss_10_pct | 5% or 10% below the first weight logged |
goal_weight_reached | At or below the health profile's goal_weight_kg |
first_meal_logged, logging_streak_7, logging_streak_30, protein_target_days_7, protein_target_days_30, workouts_10, workouts_50, injections_on_time_4, injections_on_time_12, week_4_completed, week_12_completed, weight_loss_5_pct, weight_loss_10_pct, goal_weight_reached "protein_target_days_7"
logging, nutrition, activity, treatment, program, weight "nutrition"
A short headline in the patient's language.
"7 days at your protein target"
One personal line built from stats.
"You averaged 112 g a day, up from 74 g in your first week."
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
The patient's numbers behind the milestone. Keys depend on the code.
Show child attributes
Show child attributes
{
"days": 7,
"avg_protein_g": 112,
"first_week_avg_protein_g": 74
}