List All Interactions
Lists all existing interactions. Results can be filtered by encounter status and patient ID.
curl --request GET \
--url https://api.{environment}.corti.app/v2/interactions/
{
"interactions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assignedUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"encounter": {
"identifier": "<string>",
"status": "planned",
"type": "first_consultation",
"period": {
"startedAt": "2023-11-07T05:31:56Z",
"startedAtTzoffset": "+00:00",
"endedAt": "2023-11-07T05:31:56Z",
"endedAtTzoffset": "+00:00"
},
"title": "<string>"
},
"patient": {
"identifier": "<string>",
"name": "<string>",
"gender": "male",
"birthDate": "2023-11-07T05:31:56Z",
"pronouns": "<string>"
},
"endedAt": "2023-11-07T05:31:56Z",
"endedAtTzoffset": "+00:00",
"createdAt": "2023-11-07T05:31:56Z",
"createdAtTzoffset": "+00:00",
"updatedAt": "2023-11-07T05:31:56Z",
"updatedAtTzoffset": "+00:00",
"websocketUrl": "<string>",
"lastUpdated": "2023-11-07T05:31:56Z"
}
]
}
Headers
Query Parameters
The number of interactions to return. For example, a pageSize of 10 will return a maximum of 10 interactions.
The number of interactions to skip. For example, index=2 with pageSize=10 will skip the first 10 interactions and return 11-20.
The status of the encounter. To filter on multiple statuses, pass the same parameter again (e.g. encounterStatus=in-progress&encounterStatus=completed). The options are: planned, in-progress, on-hold, completed, cancelled, deleted.
A unique identifier for the patient.
Response
Unique identifier for the interaction
A unique identifier for the medical professional
A unique identifier for the encounter, essential for tracking and referencing specific patient interactions.
Indicates the current state of the encounter, crucial for understanding the progression and current state of care.
planned
, in-progress
, on-hold
, completed
, cancelled
, deleted
The specific type of encounter, providing context about the nature and setting of the patient interaction.
first_consultation
, consultation
, emergency
, inpatient
, outpatient
The time period during which the encounter takes place.
The start date/time of the encounter. (UTC)
Timezone offset for startedAt
The end date/time of the encounter. (UTC)
Timezone offset for endedAt
A readable name for the interaction
FHIR reference to patient identifier.
FHIR reference to Text representation of the full name. Ensures the patient is referred by their name in the documentation.
FHIR reference to patient gender. Ensures the documentation is written with the correct pronouns.
male
, female
, unknown
, other
FHIR reference to patient birth date.
FHIR reference to patient extension Individual Pronouns.
append to this url your token, in the form: /interactions/{interactionID}/streams?token=Bearer token-value-here
Was this page helpful?
curl --request GET \
--url https://api.{environment}.corti.app/v2/interactions/
{
"interactions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assignedUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"encounter": {
"identifier": "<string>",
"status": "planned",
"type": "first_consultation",
"period": {
"startedAt": "2023-11-07T05:31:56Z",
"startedAtTzoffset": "+00:00",
"endedAt": "2023-11-07T05:31:56Z",
"endedAtTzoffset": "+00:00"
},
"title": "<string>"
},
"patient": {
"identifier": "<string>",
"name": "<string>",
"gender": "male",
"birthDate": "2023-11-07T05:31:56Z",
"pronouns": "<string>"
},
"endedAt": "2023-11-07T05:31:56Z",
"endedAtTzoffset": "+00:00",
"createdAt": "2023-11-07T05:31:56Z",
"createdAtTzoffset": "+00:00",
"updatedAt": "2023-11-07T05:31:56Z",
"updatedAtTzoffset": "+00:00",
"websocketUrl": "<string>",
"lastUpdated": "2023-11-07T05:31:56Z"
}
]
}