inou Health Dossier API
Authentication
All endpoints require a token query parameter - your authentication token (dossier GUID).
Base URL
https://inou.com
Endpoints
GET /api/dossiers
List all patient dossiers accessible to this account.
Parameters:
- token (required) - Your authentication token
- format (optional) - Set to "text" for plain text output
Example: GET https://inou.com/api/dossiers?token=YOUR_TOKEN
GET /api/studies
List all imaging studies in a dossier.
Parameters:
- token (required) - Your authentication token
- dossier_guid (required) - The dossier GUID to query
- format (optional) - Set to "text" for plain text output
Example: GET https://inou.com/api/studies?token=YOUR_TOKEN&dossier_guid=DOSSIER_ID
GET /api/series
List all series in a study.
Parameters:
- token (required) - Your authentication token
- dossier_guid (required) - The dossier GUID
- study_guid (required) - The study GUID
- filter (optional) - Filter by description (e.g., "T1", "FLAIR", "SAG")
- format (optional) - Set to "text" for plain text output
Example: GET https://inou.com/api/series?token=YOUR_TOKEN&dossier_guid=DOSSIER_ID&study_guid=STUDY_ID
GET /api/slices
List all slices in a series with position data.
Parameters:
- token (required) - Your authentication token
- dossier_guid (required) - The dossier GUID
- series_guid (required) - The series GUID
- format (optional) - Set to "text" for plain text output
Example: GET https://inou.com/api/slices?token=YOUR_TOKEN&dossier_guid=DOSSIER_ID&series_guid=SERIES_ID
GET /image/{slice_guid}
Fetch a slice as PNG image.
Parameters:
- slice_guid (in path, required) - The slice GUID
- token (required) - Your authentication token
- ww (optional) - Window width for contrast (Brain=80, Bone=2000)
- wc (optional) - Window center for brightness (Brain=40, Bone=500)
Example: GET https://inou.com/image/SLICE_GUID?token=YOUR_TOKEN
Default response is JSON. Add &format=text for plain text output.