Skip to main content

FAQ

Common Questions​

Which API base URL do I use?​

How do I authenticate?​

https://api.health.cloud.corsano.com:

Use a Bearer token → call Health endpoints with Authorization: Bearer <token> and Content-Type: application/json in the header.

https://api.integration.corsano.com:

Use your researcher token from Corsano Research/Patient Portal, and pass it as ?token=<RESEARCHER_TOKEN> on integration endpoints.

For the v1/user-devices endpoint on https://api.integration.corsano.com, include the header:

x-health-token: <token>

How do I get real-time data as an HCP?​

Use the Integration API with
GET /v1/groups/{GROUP_CODE}/patients?with_latest_values=1&token={TOKEN}
to include each patient’s latest measurements in the response.

How do I get raw data?​

  • Patients: Call Health API raw endpoints with your OAuth Bearer token.
    Example:
    GET /v2/raw-metrics/ppg1?from_date=...&to_date=...

  • HCPs: First fetch a patient’s health token via Integration (/v1/patients/{UUID}/health-token?token={TOKEN}), then call Health raw endpoints on their behalf.
    Raw data includes ECG, PPG, activity, sleep, etc., with limits on the max time window per request.

How can I start with Oauth 2.0?​

To use OAuth 2.0 with Corsano, first obtain a client_id and client_secret from Corsano Support by providing your app name, redirect URI, and privacy policy URL to devsupport@corsano.com, then following https://developer.corsano.com/rest/oauth-2.