curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/protocols/{protocol_type} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/protocols/{protocol_type}', 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/protocols/{protocol_type}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0190f5c6-8b9c-7d01-8e23-4f5a6b7c8d90",
"type": "nutrition",
"version": 2,
"status": "active",
"mode": "full_plan",
"title": "Protein-first nutrition, titration weeks 5-8",
"summary": "Hit 110 g of protein a day and keep meals small while the dose goes up.",
"published_at": "2026-10-25T08:00:00Z",
"published_by": "coach",
"change_reason": "Dose increased to 0.5 mg",
"content": {
"markdown": "## This week\nAim for 30 g of protein at each meal and sip water through the day.\n",
"targets": [
{
"metric": "protein_g",
"value": 110,
"unit": "g",
"label": "Protein per day"
},
{
"metric": "water_ml",
"value": 2500,
"unit": "ml",
"label": "Water per day"
}
],
"habits": [
{
"key": "protein_each_meal",
"title": "Protein at every meal",
"kind": "checkoff",
"target_value": null,
"unit": null
}
],
"meal_plan_id": "0190f5ca-1a2b-7c3d-8e4f-5a6b7c8d9e01",
"workout_plan_id": null
}
}Get my active protocol of a type
Error code: protocol_not_found (404) when there is no active protocol of this type yet.
Plans: AI + health and fitness coaches (ai_health_fitness), AI only (ai_only).
curl --request GET \
--url https://sandbox.rx.tera.health/v1/patient/protocols/{protocol_type} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/patient/protocols/{protocol_type}', 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/protocols/{protocol_type}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0190f5c6-8b9c-7d01-8e23-4f5a6b7c8d90",
"type": "nutrition",
"version": 2,
"status": "active",
"mode": "full_plan",
"title": "Protein-first nutrition, titration weeks 5-8",
"summary": "Hit 110 g of protein a day and keep meals small while the dose goes up.",
"published_at": "2026-10-25T08:00:00Z",
"published_by": "coach",
"change_reason": "Dose increased to 0.5 mg",
"content": {
"markdown": "## This week\nAim for 30 g of protein at each meal and sip water through the day.\n",
"targets": [
{
"metric": "protein_g",
"value": 110,
"unit": "g",
"label": "Protein per day"
},
{
"metric": "water_ml",
"value": 2500,
"unit": "ml",
"label": "Water per day"
}
],
"habits": [
{
"key": "protein_each_meal",
"title": "Protein at every meal",
"kind": "checkoff",
"target_value": null,
"unit": null
}
],
"meal_plan_id": "0190f5ca-1a2b-7c3d-8e4f-5a6b7c8d9e01",
"workout_plan_id": null
}
}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
nutrition, fitness, sleep, stress, lifestyle, supplements "nutrition"
Response
The active protocol.
"0190f5c6-8b9c-7d01-8e23-4f5a6b7c8d90"
nutrition, fitness, sleep, stress, lifestyle, supplements "nutrition"
2
Drafts are never shown to patients.
active, superseded "active"
full_plan protocols come with a meal or workout plan.
guideline, full_plan "full_plan"
"Protein-first nutrition, titration weeks 5-8"
ISO 8601 in UTC.
"2026-10-26T14:05:00Z"
coach when a coach approved it; ai_coach when the AI Coach published it on its own (ai_only with ai_autonomy = auto).
coach, ai_coach "coach"
Show child attributes
Show child attributes
"Hit 110 g of protein a day and keep meals small while the dose goes up."
Why this version replaced the previous one.
"Dose increased to 0.5 mg"