Web service that stores information about clinics, clinicians and their patients
Tidepool API/Clinics API//
- Delete Patient
List Clinics
Create Clinic
Get Clinic by Share Code
Get Clinic
Update Clinic
Delete Clinic
List Clinicians
Create Clinician
View TIDE Report
List Patients
Create Patient Account
Create Patient Tag
Create a Site
Update a Site
Delete a Site
Merge two sites
Get Clinician
Update Clinician
Delete Clinician
Get Patient
Create Patient from Existing User
Update Patient
Update Patient Tag
Delete Patient Tag
Convert Patient Tag to Site
Invite Clinician
Resend Clinician Invite
Delete Invite
Associate Clinician to User
Delete Invited Clinician
Get Invited Clinician
Get Patient Invites
Accept Patient Invitation
Update Patient Reviews
Delete Patient Reviews
Update Patient Permissions
Delete Patient Permission
List Clinics for Patient
List Clinician Invites
Dismiss Clinician Invite
Accept Clinician Invite
List Clinics for Clinician
Migrate Legacy Clinician Patients
Retrieve Migration Status
Enable Clinics
Trigger initial migration
Get Migration
Update Migration
Remove User from Clinics
Update User Details
List All Clinicians
UpdatePatientSummary
DeletePatientSummary
Create or update a data source for a patient
Update Tier
Update Suppressed Notifications
Send Upload Reminder
Assign Patient Tag To Clinic Patients
Delete Patient Tag From Clinic Patients
List Membership Restrictions
Update Membership Restrictions
Redox EHR Endpoint
Redox Verify Endpoint
Get EHR Settings
Update EHR Settings
Match Clinic and Patient
Get MRN Settings
Update MRN Settings
Get Patient Count Settings
Update Patient Count Settings
Get Patient Count
Refresh Patient Count
Sync EHR Data
Find Patients
Preorder Form Webhook
Get Programs
Get Program Url
Notification Webhook
View PDF Report
Add Service Account
Sync EHR Data for Patient
Generate Clinic Merge Report
Merge Clinic
Connect Provider
Delete Patient
Clinics API (1.0)
Download OpenAPI description
Overview
Languages
Servers
Mock server
https://tidepool.redocly.app/_mock/reference/clinic.v1
integration
https://external.integration.tidepool.org
production
https://api.tidepool.org
dev1
https://dev1.dev.tidepool.org
qa1
https://qa1.development.tidepool.org
qa2
https://qa2.development.tidepool.org
- Mock serverhttps://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/patients/{patientId}
- integrationhttps://external.integration.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- productionhttps://api.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- dev1https://dev1.dev.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- qa1https://qa1.development.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- qa2https://qa2.development.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/patients/{patientId}' \
-H 'Content-Type: application/json' \
-H 'x-tidepool-session-token: YOUR_API_KEY_HERE' \
-d '{
"email": "user@example.com",
"fullName": "string",
"birthDate": "2012-08-30",
"mrn": "string",
"tags": [
"stringstringstringstring"
],
"targetDevices": [
"string"
],
"permissions": {
"custodian": {},
"view": {},
"note": {},
"upload": {}
},
"attestationSubmitted": true,
"dataSources": [
{
"state": "connected",
"providerName": "dexcom",
"modifiedTime": "2017-02-06T02:37:46Z",
"expirationTime": "2017-02-06T02:37:46Z"
}
],
"summary": {
"cgmStats": {
"id": "2fe2488217ee43e1b2e83c2f",
"config": {
"schemaVersion": 0,
"highGlucoseThreshold": 0,
"veryHighGlucoseThreshold": 0,
"lowGlucoseThreshold": 0,
"veryLowGlucoseThreshold": 0
},
"dates": {
"lastUpdatedDate": "2019-08-24T14:15:22Z",
"lastUpdatedReason": [
"string"
],
"hasFirstData": true,
"firstData": "2019-08-24T14:15:22Z",
"hasLastData": true,
"lastData": "2019-08-24T14:15:22Z",
"hasLastUploadDate": true,
"lastUploadDate": "2019-08-24T14:15:22Z",
"hasOutdatedSince": true,
"outdatedSince": "2019-08-24T14:15:22Z",
"outdatedSinceLimit": "2019-08-24T14:15:22Z",
"outdatedReason": [
"string"
]
},
"periods": {
"property1": {
"min": 3,
"minDelta": 3,
"max": 8,
"maxDelta": 8,
"hasAverageGlucoseMmol": true,
"averageGlucoseMmol": 5.5,
"averageGlucoseMmolDelta": 2.5,
"hasGlucoseManagementIndicator": true,
"glucoseManagementIndicator": 7.5,
"glucoseManagementIndicatorDelta": 7.5,
"hasTimeInTargetPercent": true,
"timeInTargetPercent": 0.35,
"timeInTargetPercentDelta": 0.2,
"hasTimeInTargetMinutes": true,
"timeInTargetMinutes": 200,
"timeInTargetMinutesDelta": 20,
"hasTimeInTargetRecords": true,
"timeInTargetRecords": 10,
"timeInTargetRecordsDelta": 5,
"hasTimeInHighPercent": true,
"timeInHighPercent": 0.35,
"timeInHighPercentDelta": 0.2,
"hasTimeInHighMinutes": true,
"timeInHighMinutes": 200,
"timeInHighMinutesDelta": 20,
"hasTimeInHighRecords": true,
"timeInHighRecords": 10,
"timeInHighRecordsDelta": 5,
"hasTimeInVeryHighPercent": true,
"timeInVeryHighPercent": 0.35,
"timeInVeryHighPercentDelta": 0.2,
"hasTimeInVeryHighMinutes": true,
"timeInVeryHighMinutes": 200,
"timeInVeryHighMinutesDelta": 5,
"hasTimeInVeryHighRecords": true,
"timeInVeryHighRecords": 10,
"timeInVeryHighRecordsDelta": 5,
"hasTimeInExtremeHighPercent": true,
"timeInExtremeHighPercent": 0.35,
"timeInExtremeHighPercentDelta": 0.2,
"hasTimeInExtremeHighMinutes": true,
"timeInExtremeHighMinutes": 200,
"timeInExtremeHighMinutesDelta": 5,
"hasTimeInExtremeHighRecords": true,
"timeInExtremeHighRecords": 10,
"timeInExtremeHighRecordsDelta": 5,
"hasTimeInAnyHighPercent": true,
"timeInAnyHighPercent": 0.35,
"timeInAnyHighPercentDelta": 0.2,
"hasTimeInAnyHighMinutes": true,
"timeInAnyHighMinutes": 200,
"timeInAnyHighMinutesDelta": 5,
"hasTimeInAnyHighRecords": true,
"timeInAnyHighRecords": 10,
"timeInAnyHighRecordsDelta": 5,
"hasTimeInLowPercent": true,
"timeInLowPercent": 0.35,
"timeInLowPercentDelta": 0.2,
"hasTimeInLowMinutes": true,
"timeInLowMinutes": 200,
"timeInLowMinutesDelta": 5,
"hasTimeInLowRecords": true,
"timeInLowRecords": 10,
"timeInLowRecordsDelta": 5,
"hasTimeInVeryLowPercent": true,
"timeInVeryLowPercent": 0.35,
"timeInVeryLowPercentDelta": 0.2,
"hasTimeInVeryLowMinutes": true,
"timeInVeryLowMinutes": 200,
"timeInVeryLowMinutesDelta": 5,
"hasTimeInVeryLowRecords": true,
"timeInVeryLowRecords": 10,
"timeInVeryLowRecordsDelta": 5,
"hasTimeInAnyLowPercent": true,
"timeInAnyLowPercent": 0.35,
"timeInAnyLowPercentDelta": 0.2,
"hasTimeInAnyLowMinutes": true,
"timeInAnyLowMinutes": 200,
"timeInAnyLowMinutesDelta": 5,
"hasTimeInAnyLowRecords": true,
"timeInAnyLowRecords": 10,
"timeInAnyLowRecordsDelta": 5,
"hasTimeCGMUsePercent": true,
"timeCGMUsePercent": 0.35,
"timeCGMUsePercentDelta": 0.2,
"hasTimeCGMUseMinutes": true,
"timeCGMUseMinutes": 200,
"timeCGMUseMinutesDelta": 5,
"hasTimeCGMUseRecords": true,
"timeCGMUseRecords": 10,
"timeCGMUseRecordsDelta": 5,
"hasTotalRecords": true,
"totalRecords": 10,
"totalRecordsDelta": 10,
"hasAverageDailyRecords": true,
"averageDailyRecords": 3.5,
"averageDailyRecordsDelta": 2.5,
"standardDeviation": 2.5,
"standardDeviationDelta": 2.5,
"coefficientOfVariation": 2.5,
"coefficientOfVariationDelta": 2.5,
"hoursWithData": 2,
"hoursWithDataDelta": 2,
"daysWithData": 2,
"daysWithDataDelta": 2
},
"property2": {
"min": 3,
"minDelta": 3,
"max": 8,
"maxDelta": 8,
"hasAverageGlucoseMmol": true,
"averageGlucoseMmol": 5.5,
"averageGlucoseMmolDelta": 2.5,
"hasGlucoseManagementIndicator": true,
"glucoseManagementIndicator": 7.5,
"glucoseManagementIndicatorDelta": 7.5,
"hasTimeInTargetPercent": true,
"timeInTargetPercent": 0.35,
"timeInTargetPercentDelta": 0.2,
"hasTimeInTargetMinutes": true,
"timeInTargetMinutes": 200,
"timeInTargetMinutesDelta": 20,
"hasTimeInTargetRecords": true,
"timeInTargetRecords": 10,
"timeInTargetRecordsDelta": 5,
"hasTimeInHighPercent": true,
"timeInHighPercent": 0.35,
"timeInHighPercentDelta": 0.2,
"hasTimeInHighMinutes": true,
"timeInHighMinutes": 200,
"timeInHighMinutesDelta": 20,
"hasTimeInHighRecords": true,
"timeInHighRecords": 10,
"timeInHighRecordsDelta": 5,
"hasTimeInVeryHighPercent": true,
"timeInVeryHighPercent": 0.35,
"timeInVeryHighPercentDelta": 0.2,
"hasTimeInVeryHighMinutes": true,
"timeInVeryHighMinutes": 200,
"timeInVeryHighMinutesDelta": 5,
"hasTimeInVeryHighRecords": true,
"timeInVeryHighRecords": 10,
"timeInVeryHighRecordsDelta": 5,
"hasTimeInExtremeHighPercent": true,
"timeInExtremeHighPercent": 0.35,
"timeInExtremeHighPercentDelta": 0.2,
"hasTimeInExtremeHighMinutes": true,
"timeInExtremeHighMinutes": 200,
"timeInExtremeHighMinutesDelta": 5,
"hasTimeInExtremeHighRecords": true,
"timeInExtremeHighRecords": 10,
"timeInExtremeHighRecordsDelta": 5,
"hasTimeInAnyHighPercent": true,
"timeInAnyHighPercent": 0.35,
"timeInAnyHighPercentDelta": 0.2,
"hasTimeInAnyHighMinutes": true,
"timeInAnyHighMinutes": 200,
"timeInAnyHighMinutesDelta": 5,
"hasTimeInAnyHighRecords": true,
"timeInAnyHighRecords": 10,
"timeInAnyHighRecordsDelta": 5,
"hasTimeInLowPercent": true,
"timeInLowPercent": 0.35,
"timeInLowPercentDelta": 0.2,
"hasTimeInLowMinutes": true,
"timeInLowMinutes": 200,
"timeInLowMinutesDelta": 5,
"hasTimeInLowRecords": true,
"timeInLowRecords": 10,
"timeInLowRecordsDelta": 5,
"hasTimeInVeryLowPercent": true,
"timeInVeryLowPercent": 0.35,
"timeInVeryLowPercentDelta": 0.2,
"hasTimeInVeryLowMinutes": true,
"timeInVeryLowMinutes": 200,
"timeInVeryLowMinutesDelta": 5,
"hasTimeInVeryLowRecords": true,
"timeInVeryLowRecords": 10,
"timeInVeryLowRecordsDelta": 5,
"hasTimeInAnyLowPercent": true,
"timeInAnyLowPercent": 0.35,
"timeInAnyLowPercentDelta": 0.2,
"hasTimeInAnyLowMinutes": true,
"timeInAnyLowMinutes": 200,
"timeInAnyLowMinutesDelta": 5,
"hasTimeInAnyLowRecords": true,
"timeInAnyLowRecords": 10,
"timeInAnyLowRecordsDelta": 5,
"hasTimeCGMUsePercent": true,
"timeCGMUsePercent": 0.35,
"timeCGMUsePercentDelta": 0.2,
"hasTimeCGMUseMinutes": true,
"timeCGMUseMinutes": 200,
"timeCGMUseMinutesDelta": 5,
"hasTimeCGMUseRecords": true,
"timeCGMUseRecords": 10,
"timeCGMUseRecordsDelta": 5,
"hasTotalRecords": true,
"totalRecords": 10,
"totalRecordsDelta": 10,
"hasAverageDailyRecords": true,
"averageDailyRecords": 3.5,
"averageDailyRecordsDelta": 2.5,
"standardDeviation": 2.5,
"standardDeviationDelta": 2.5,
"coefficientOfVariation": 2.5,
"coefficientOfVariationDelta": 2.5,
"hoursWithData": 2,
"hoursWithDataDelta": 2,
"daysWithData": 2,
"daysWithDataDelta": 2
}
}
},
"bgmStats": {
"id": "2fe2488217ee43e1b2e83c2f",
"config": {
"schemaVersion": 0,
"highGlucoseThreshold": 0,
"veryHighGlucoseThreshold": 0,
"lowGlucoseThreshold": 0,
"veryLowGlucoseThreshold": 0
},
"dates": {
"lastUpdatedDate": "2019-08-24T14:15:22Z",
"lastUpdatedReason": [
"string"
],
"hasFirstData": true,
"firstData": "2019-08-24T14:15:22Z",
"hasLastData": true,
"lastData": "2019-08-24T14:15:22Z",
"hasLastUploadDate": true,
"lastUploadDate": "2019-08-24T14:15:22Z",
"hasOutdatedSince": true,
"outdatedSince": "2019-08-24T14:15:22Z",
"outdatedSinceLimit": "2019-08-24T14:15:22Z",
"outdatedReason": [
"string"
]
},
"periods": {
"property1": {
"min": 3,
"minDelta": 3,
"max": 8,
"maxDelta": 8,
"hasAverageGlucoseMmol": true,
"averageGlucoseMmol": 5.5,
"averageGlucoseMmolDelta": 2.5,
"hasTimeInTargetPercent": true,
"timeInTargetPercent": 0.35,
"timeInTargetPercentDelta": 0.2,
"hasTimeInTargetRecords": true,
"timeInTargetRecords": 10,
"timeInTargetRecordsDelta": 5,
"hasTimeInHighPercent": true,
"timeInHighPercent": 0.35,
"timeInHighPercentDelta": 0.2,
"hasTimeInHighRecords": true,
"timeInHighRecords": 10,
"timeInHighRecordsDelta": 5,
"hasTimeInVeryHighPercent": true,
"timeInVeryHighPercent": 0.35,
"timeInVeryHighPercentDelta": 0.2,
"hasTimeInVeryHighRecords": true,
"timeInVeryHighRecords": 10,
"timeInVeryHighRecordsDelta": 5,
"hasTimeInExtremeHighPercent": true,
"timeInExtremeHighPercent": 0.35,
"timeInExtremeHighPercentDelta": 0.2,
"hasTimeInExtremeHighRecords": true,
"timeInExtremeHighRecords": 10,
"timeInExtremeHighRecordsDelta": 5,
"hasTimeInAnyHighPercent": true,
"timeInAnyHighPercent": 0.35,
"timeInAnyHighPercentDelta": 0.2,
"hasTimeInAnyHighRecords": true,
"timeInAnyHighRecords": 10,
"timeInAnyHighRecordsDelta": 5,
"hasTimeInLowPercent": true,
"timeInLowPercent": 0.35,
"timeInLowPercentDelta": 0.2,
"hasTimeInLowRecords": true,
"timeInLowRecords": 10,
"timeInLowRecordsDelta": 5,
"hasTimeInVeryLowPercent": true,
"timeInVeryLowPercent": 0.35,
"timeInVeryLowPercentDelta": 0.2,
"hasTimeInVeryLowRecords": true,
"timeInVeryLowRecords": 10,
"timeInVeryLowRecordsDelta": 5,
"hasTimeInAnyLowPercent": true,
"timeInAnyLowPercent": 0.35,
"timeInAnyLowPercentDelta": 0.2,
"hasTimeInAnyLowRecords": true,
"timeInAnyLowRecords": 10,
"timeInAnyLowRecordsDelta": 5,
"hasTotalRecords": true,
"totalRecords": 10,
"totalRecordsDelta": 10,
"hasAverageDailyRecords": true,
"averageDailyRecords": 3.5,
"averageDailyRecordsDelta": 2.5,
"standardDeviation": 2.5,
"standardDeviationDelta": 2.5,
"coefficientOfVariation": 2.5,
"coefficientOfVariationDelta": 2.5,
"daysWithData": 2,
"daysWithDataDelta": 2
},
"property2": {
"min": 3,
"minDelta": 3,
"max": 8,
"maxDelta": 8,
"hasAverageGlucoseMmol": true,
"averageGlucoseMmol": 5.5,
"averageGlucoseMmolDelta": 2.5,
"hasTimeInTargetPercent": true,
"timeInTargetPercent": 0.35,
"timeInTargetPercentDelta": 0.2,
"hasTimeInTargetRecords": true,
"timeInTargetRecords": 10,
"timeInTargetRecordsDelta": 5,
"hasTimeInHighPercent": true,
"timeInHighPercent": 0.35,
"timeInHighPercentDelta": 0.2,
"hasTimeInHighRecords": true,
"timeInHighRecords": 10,
"timeInHighRecordsDelta": 5,
"hasTimeInVeryHighPercent": true,
"timeInVeryHighPercent": 0.35,
"timeInVeryHighPercentDelta": 0.2,
"hasTimeInVeryHighRecords": true,
"timeInVeryHighRecords": 10,
"timeInVeryHighRecordsDelta": 5,
"hasTimeInExtremeHighPercent": true,
"timeInExtremeHighPercent": 0.35,
"timeInExtremeHighPercentDelta": 0.2,
"hasTimeInExtremeHighRecords": true,
"timeInExtremeHighRecords": 10,
"timeInExtremeHighRecordsDelta": 5,
"hasTimeInAnyHighPercent": true,
"timeInAnyHighPercent": 0.35,
"timeInAnyHighPercentDelta": 0.2,
"hasTimeInAnyHighRecords": true,
"timeInAnyHighRecords": 10,
"timeInAnyHighRecordsDelta": 5,
"hasTimeInLowPercent": true,
"timeInLowPercent": 0.35,
"timeInLowPercentDelta": 0.2,
"hasTimeInLowRecords": true,
"timeInLowRecords": 10,
"timeInLowRecordsDelta": 5,
"hasTimeInVeryLowPercent": true,
"timeInVeryLowPercent": 0.35,
"timeInVeryLowPercentDelta": 0.2,
"hasTimeInVeryLowRecords": true,
"timeInVeryLowRecords": 10,
"timeInVeryLowRecordsDelta": 5,
"hasTimeInAnyLowPercent": true,
"timeInAnyLowPercent": 0.35,
"timeInAnyLowPercentDelta": 0.2,
"hasTimeInAnyLowRecords": true,
"timeInAnyLowRecords": 10,
"timeInAnyLowRecordsDelta": 5,
"hasTotalRecords": true,
"totalRecords": 10,
"totalRecordsDelta": 10,
"hasAverageDailyRecords": true,
"averageDailyRecords": 3.5,
"averageDailyRecordsDelta": 2.5,
"standardDeviation": 2.5,
"standardDeviationDelta": 2.5,
"coefficientOfVariation": 2.5,
"coefficientOfVariationDelta": 2.5,
"daysWithData": 2,
"daysWithDataDelta": 2
}
}
}
},
"reviews": [
{
"clinicianId": "string",
"time": "2019-08-24T14:15:22Z"
}
],
"sites": [
{
"name": "string",
"numPatients": 0
}
],
"glycemicRanges": {
"type": "preset",
"custom": {
"name": "string",
"thresholds": [
{
"name": "string",
"upperBound": {
"value": 0.1,
"units": "mg/dL"
},
"inclusive": false
}
]
},
"preset": "adaStandard"
},
"diagnosisType": "type1"
}'OK
String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit UUID v4
Response
application/json
{ "id": "string", "email": "user@example.com", "fullName": "string", "birthDate": "2012-08-30", "mrn": "string", "tags": [ "stringstringstringstring" ], "targetDevices": [ "string" ], "permissions": { "custodian": {}, "view": {}, "note": {}, "upload": {} }, "createdTime": "2019-08-24T14:15:22Z", "updatedTime": "2019-08-24T14:15:22Z", "attestationSubmitted": true, "dataSources": [ { … } ], "lastUploadReminderTime": "2019-08-24T14:15:22Z", "summary": { "cgmStats": { … }, "bgmStats": { … } }, "reviews": [ { … } ], "connectionRequests": { "twiist": [ … ], "dexcom": [ … ], "abbott": [ … ] }, "sites": [ { … } ], "glycemicRanges": { "type": "preset", "custom": { … }, "preset": "adaStandard" }, "diagnosisType": "type1" }
- Mock serverhttps://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/patients/{patientId}
- integrationhttps://external.integration.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- productionhttps://api.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- dev1https://dev1.dev.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- qa1https://qa1.development.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- qa2https://qa2.development.tidepool.org/v1/clinics/{clinicId}/patients/{patientId}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/patients/{patientId}' \
-H 'x-tidepool-session-token: YOUR_API_KEY_HERE'- Mock serverhttps://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/patient_tags/{patientTagId}
- integrationhttps://external.integration.tidepool.org/v1/clinics/{clinicId}/patient_tags/{patientTagId}
- productionhttps://api.tidepool.org/v1/clinics/{clinicId}/patient_tags/{patientTagId}
- dev1https://dev1.dev.tidepool.org/v1/clinics/{clinicId}/patient_tags/{patientTagId}
- qa1https://qa1.development.tidepool.org/v1/clinics/{clinicId}/patient_tags/{patientTagId}
- qa2https://qa2.development.tidepool.org/v1/clinics/{clinicId}/patient_tags/{patientTagId}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/patient_tags/{patientTagId}' \
-H 'Content-Type: application/json' \
-H 'x-tidepool-session-token: YOUR_API_KEY_HERE' \
-d '{
"name": "string",
"numPatients": 0
}'Response
application/json
{ "id": "stringstringstringstring", "name": "string", "numPatients": 0 }