Creating export of the raw data

In this tutorial we will show you how to create and export file with raw data.

First of all you need to have a study admin token. You can learn how to get it here.

Also you need to know the UUID of the patient you need the data from.

To create an export file you need to make a POST request to

https://api.integration.corsano.com/v1/create-export/{UUID}/{data_type}?token=XYZ

Note: Export requests via this endpoint are limited to 1 per user (UUID) every 5 minutes (If you want to increase the limit for each UUID, please contact devsupport@corsano.com).

Data_type

activity
rr-interval
sleep
temperature
heart-rate-variability
ppg1
ppg2
bioz
acc
ecg
tests

Example

curl --request POST \
  --url 'https://api.integration.corsano.com/v1/create-export/50907d67-1575-4599-8693-80b14e68b57b?token=xyz' \
  --header 'Content-Type: application/json' \
  --data '{
    "client_date_from": "2023-06-05T00:00:00.000",
    "client_date_to": "2023-06-05T10:00:00.000",
    "types": ["activity", "sleep", "ppg1"]
}'

In return you will get the following structure:

{
    "id": "647d976a8f95762a8768d725",
    "status": "in_progress"
}

You need to request the status of the export until it's not equal to "done"

To do that you need to make a GET request to

https://api.integration.corsano.com/v1/export/{EXPORT_ID}?token=XYZ

Example

curl --request GET \
  --url 'https://api.integration.corsano.com/v1/export/647d9d648b5f5472ed5d8727?token=XYZ' \

In return you will get the object with the following structure:

{
  "status": "done",
  "id": "647d9ef0eaf06f6e1a2d86b2",
  "downloadUrl": "https://cloudconnect-uploads-prod.s3.eu-central-1.amazonaws.com/raw-metrics-export/647d9ef0eaf06f6e1a2d86b2.zip?response-content-disposition=attachment%3B%20filename%3D%22647d9ef0eaf06f6e1a2d86b2.zip%22&response-content-type=application%2Fzip&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA2NPJAASWBOJHKNZP%2F20230605%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20230605T084728Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=92448788b769e3b1dd2be1a22132cffb00d44017acc7017523c31a7e17384fe0"
}

The value of "downloadUrl" is the URL of the ZIP archive you can download.

Creating export of the raw data

Example​

Example​

Example

Example