Skip to content

Clinics API (1.0)

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

Download OpenAPI description
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

Confirmations

Manage confirmations for account creation, sharing invites, etc.

Operations

Internal

APIs intended for internal use by Tidepool.

Operations

Request

Update MRN Settings

Security
sessionToken
Path
clinicIdstring^[a-f0-9]{24}$required
Bodyapplication/json
requiredbooleanrequired

Require MRN when creating or updating patients

uniquebooleanrequired

Enforce MRN uniqueness constraint

curl -i -X PUT \
  'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/settings/mrn' \
  -H 'Content-Type: application/json' \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE' \
  -d '{
    "required": true,
    "unique": true
  }'

Responses

OK

Request

Update Patient Count Settings

Security
sessionToken
Path
clinicIdstring^[a-f0-9]{24}$required
Bodyapplication/json
hardLimitobject(Patient Count Limit)
softLimitobject(Patient Count Limit)
curl -i -X PUT \
  'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/settings/patient_count' \
  -H 'Content-Type: application/json' \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE' \
  -d '{
    "hardLimit": {
      "patientCount": 0,
      "startDate": "2017-02-06T02:37:46Z",
      "endDate": "2017-02-06T02:37:46Z"
    },
    "softLimit": {
      "patientCount": 0,
      "startDate": "2017-02-06T02:37:46Z",
      "endDate": "2017-02-06T02:37:46Z"
    }
  }'

Responses

OK

Request

An internal endpoint which will push the latest patient summary statistics and PDF reports for all patients who have an active subscription. The actual data is pushed asynchronously. A successful response means that an asynchronous task has been scheduled for each patient of the clinic with an active subscription.

Will return 404 Not Found if the clinic does not have an active EHR connection.

Security
sessionToken
Path
clinicIdstring^[a-f0-9]{24}$required
curl -i -X POST \
  'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/ehr/sync' \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE'

Responses

Accepted

Redox

Public endpoints invoked by Redox.

Operations