Skip to content
Tidepool API/Clinics API/
/
DeletePatientSummary

Clinics API (1.0)

Web service that stores information about clinics, clinicians and their patients

Download OpenAPI description
clinic.v1.json
clinic.v1.yaml
Overview
URL

https://www.tidepool.org

Tidepool

support@tidepool.org

License

BSD-2-Clause

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/

Clinics

Manage clinics, clinians and patients.

Operations

UpdatePatientSummary

Request

Internal endpoint which updates the summary in all patient records which match the user id.

Security
sessionToken
Path
patientIdstring^([0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-...required
Bodyapplication/json
cgmStatsobject(cgmstats.v1)

A summary of a users recent CGM glucose values

bgmStatsobject(bgmstats.v1)

A summary of a users recent BGM glucose values

curl -i -X POST \
  'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/patients/{patientId}/summary' \
  -H 'Content-Type: application/json' \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE' \
  -d '{
    "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
        }
      }
    }
  }'

Responses

OK

DeletePatientSummary

Request

Internal endpoint which deletes the summary in all patient records which match the summary id.

Security
sessionToken
Path
summaryIdstring(Summary ID)[ 0 .. 24 ] characters^[a-f0-9]{0,24}$required

Summary Unique Identifier

Example: 2fe2488217ee43e1b2e83c2f
curl -i -X DELETE \
  https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/summaries/2fe2488217ee43e1b2e83c2f/clinics \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE'

Responses

OK

Create or update a data source for a patient

Request

Internal endpoint to upsert patient data source provider details in all their associated clinic records.

Security
sessionToken
Path
userIdstring(Tidepool User ID)^([0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-...read-onlyrequired

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

Bodyapplication/jsonArray [
statestring(Data source connection state)required
Enum"pending""pendingReconnect""connected""disconnected""error"
Example: "connected"
providerNamestring(Provider Name)[ 1 .. 100 ] charactersrequired
Example: "dexcom"
modifiedTimestring(date-time)(Date/Time)

RFC 3339 / ISO 8601 timestamp with timezone information

Example: "2017-02-06T02:37:46Z"
expirationTimestring(date-time)(Date/Time)

RFC 3339 / ISO 8601 timestamp with timezone information

Example: "2017-02-06T02:37:46Z"
]
curl -i -X PUT \
  'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/patients/{userId}/data_sources' \
  -H 'Content-Type: application/json' \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "state": "connected",
      "providerName": "dexcom",
      "modifiedTime": "2017-02-06T02:37:46Z",
      "expirationTime": "2017-02-06T02:37:46Z"
    }
  ]'

Responses

OK

Confirmations

Manage confirmations for account creation, sharing invites, etc.

Operations

Internal

APIs intended for internal use by Tidepool.

Operations

Redox

Public endpoints invoked by Redox.

Operations