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

Notification Webhook

Request

Security
sessionToken
curl -i -X POST \
  https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/xealth/notification \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE'

Responses

OK

View PDF Report

Request

View PDF report for a given patient of a clinic

Security
sessionToken
Query
clinicIdstringrequired
patientIdstringrequired
restricted_tokenstringrequired
curl -i -X GET \
  'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/xealth/report/web/viewer.html?clinicId=string&patientId=string&restricted_token=string' \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE'

Responses

OK

Add Service Account

Request

Adds authentication client's service account as a new clinician member.

Security
sessionToken
Path
clinicIdstring^[a-f0-9]{24}$required
Bodyapplication/json
namestringnon-emptyrequired
client_idstringnon-emptyrequired
client_secretstringnon-emptyrequired
curl -i -X POST \
  'https://tidepool.redocly.app/_mock/reference/clinic.v1/v1/clinics/{clinicId}/service_accounts' \
  -H 'Content-Type: application/json' \
  -H 'x-tidepool-session-token: YOUR_API_KEY_HERE' \
  -d '{
    "name": "string",
    "client_id": "string",
    "client_secret": "string"
  }'

Responses

OK

Redox

Public endpoints invoked by Redox.

Operations