curl --request GET \
--url https://sandbox.rx.tera.health/v1/events \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "0190f5d8-4b2d-7e6f-8a21-c2d3e4f5a6b7",
"type": "clinical.flag_raised",
"created_at": "2026-10-26T14:05:00Z",
"tenant_id": "a0000000-0000-4000-8000-000000000002",
"data": {
"enrollment_id": "0190f5c2-3a1b-7c4d-8e9f-a0b1c2d3e4f5",
"external_patient_id": "brand-pt-48213",
"flag_id": "0190f5d8-4b2c-7d5e-9f10-b1c2d3e4f5a6",
"severity": "critical",
"raised_risk_to": "high",
"ack_due_at": "2026-10-26T16:05:00Z"
}
},
{
"id": "0190f5e1-0a1b-7c2d-9e3f-4a5b6c7d8e9f",
"type": "clinical.flag_acknowledged",
"created_at": "2026-10-26T14:20:00Z",
"tenant_id": "a0000000-0000-4000-8000-000000000002",
"data": {
"enrollment_id": "0190f5c2-3a1b-7c4d-8e9f-a0b1c2d3e4f5",
"external_patient_id": "brand-pt-48213",
"flag_id": "0190f5d8-4b2c-7d5e-9f10-b1c2d3e4f5a6",
"acknowledged_at": "2026-10-26T14:20:00Z"
}
}
],
"next_cursor": null
}Replay events
The same events as the webhooks, oldest first, for the last 30 days. After an outage, pass the id of the last
event you processed as since, then follow next_cursor until it is null. Every event appears exactly once,
in order; events outside the 30-day window are gone.
Error code: event_too_old (410) when since is older than 30 days.
Scope: events:read.
curl --request GET \
--url https://sandbox.rx.tera.health/v1/events \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.rx.tera.health/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.rx.tera.health/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "0190f5d8-4b2d-7e6f-8a21-c2d3e4f5a6b7",
"type": "clinical.flag_raised",
"created_at": "2026-10-26T14:05:00Z",
"tenant_id": "a0000000-0000-4000-8000-000000000002",
"data": {
"enrollment_id": "0190f5c2-3a1b-7c4d-8e9f-a0b1c2d3e4f5",
"external_patient_id": "brand-pt-48213",
"flag_id": "0190f5d8-4b2c-7d5e-9f10-b1c2d3e4f5a6",
"severity": "critical",
"raised_risk_to": "high",
"ack_due_at": "2026-10-26T16:05:00Z"
}
},
{
"id": "0190f5e1-0a1b-7c2d-9e3f-4a5b6c7d8e9f",
"type": "clinical.flag_acknowledged",
"created_at": "2026-10-26T14:20:00Z",
"tenant_id": "a0000000-0000-4000-8000-000000000002",
"data": {
"enrollment_id": "0190f5c2-3a1b-7c4d-8e9f-a0b1c2d3e4f5",
"external_patient_id": "brand-pt-48213",
"flag_id": "0190f5d8-4b2c-7d5e-9f10-b1c2d3e4f5a6",
"acknowledged_at": "2026-10-26T14:20:00Z"
}
}
],
"next_cursor": null
}Authorizations
A brand's server, one OAuth client per brand and environment. Get a token with the
client_credentials grant and send it as Authorization: Bearer <token>. Tokens last 1 hour.
A brand server reads status and ids only; it never reads clinical content. A platform partner holds one
client for all its brands and gets one token per brand, naming it with tenant_id.
Query Parameters
Start after this event id (exclusive). Omit to start at the oldest event kept.
Only these event types, comma-separated.
enrollment.created, enrollment.stage_changed, enrollment.paused, enrollment.resumed, enrollment.cancelled, care_team.assigned, care_team.changed, care_team.capacity_warning, care_team.feedback_due, form.requested, onboarding.completed, protocol.published, protocol.updated, message.created, clinical.flag_raised, clinical.flag_redelivered, clinical.flag_acknowledged, clinical.flag_resolved, patient.disengaged, patient.milestone_reached, reminder.due, data_request.completed Page size.
1 <= x <= 100The next_cursor from the previous page. Omit it for the first page.
512Response
A page of events.
Oldest first, in the order they were written.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
- Option 19
- Option 20
- Option 21
- Option 22
Show child attributes
Show child attributes
Pass it back as cursor for the next page. null on the last page.
"eyJpZCI6IjAxOTBmNWMyIn0"