GET api/patientcommunications/search?status={status}&creationDateOperator={creationDateOperator}&utcCreationDate1={utcCreationDate1}&utcCreationDate2={utcCreationDate2}&alreadySent={alreadySent}&patientExternalId={patientExternalId}&appointmentExternalId={appointmentExternalId}&outgoing={outgoing}&page={page}&itemsPerPage={itemsPerPage}
Returns a list of patient communications.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| status |
Current Status of patient communication. Possible values: Succeed, Failed, Delayed, NotAcceptedByPatient and Retried |
string |
Default value is empty string ("") |
| creationDateOperator |
Date creation a patient communication's comparison operators. Possible values: NotCompare (equals to empty string ""), Equals, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, Between, DifferentThan, Contains, StartsWith |
string |
Default value is empty string ("") |
| utcCreationDate1 |
Date that is created a patient communication. |
date |
None. |
| utcCreationDate2 |
Second date that is created a patient communication. |
date |
None. |
| alreadySent |
Filter patient communications on whether they are already sent or not. |
boolean |
None. |
| patientExternalId |
Patient's unique ID on integrating system. |
string |
Default value is empty string ("") |
| appointmentExternalId |
Appointment's unique ID on integrating system. |
string |
Default value is empty string ("") |
| outgoing |
Filter patient communications on whether they are outgoing or not. |
boolean |
None. |
| page |
Page number requested (search results are paginated). |
integer |
Default value is 1 |
| itemsPerPage |
Items to return on each page. See page parameter above. |
integer |
Default value is 10 |
Body Parameters
None.
Response Information
Resource Description
ListModelOfPatientCommunicationModel| Name | Description | Type | Additional information |
|---|---|---|---|
| TotalItems | integer |
None. |
|
| ItemsPerPage | integer |
None. |
|
| CurrentPage | integer |
None. |
|
| TotalPages | integer |
None. |
|
| FirstRowOnPage | integer |
None. |
|
| LastRowOnPage | integer |
None. |
|
| Rows | Collection of PatientCommunicationModel |
None. |
Response Formats
application/json, text/json
Sample:
{
"totalItems": 1,
"itemsPerPage": 2,
"currentPage": 3,
"totalPages": 4,
"firstRowOnPage": 5,
"lastRowOnPage": 6,
"rows": [
{
"patientCommunicationID": "b5529f74-0f34-4102-aa93-f04be748e454",
"accountName": "sample string 2",
"created": "2026-07-14T01:55:48.0369346+00:00",
"createdUtc": "2026-07-14T01:55:48.0369346+00:00",
"method": "sample string 5",
"type": "sample string 6",
"status": "sample string 7",
"allowToCancelAppointmentsDuringCommunications": true,
"from": "sample string 9",
"to": "sample string 10",
"messageSubject": "sample string 11",
"messageBody": "sample string 12",
"messageVoiceHuman": "sample string 13",
"messageVoiceMachine": "sample string 14",
"outgoing": true,
"locationPhoneNumber": "sample string 16",
"patientExternalId": "sample string 17",
"eyewearReadySetToStatusId": "dc3ef02f-3bec-4053-b301-ccb7706290ce",
"appointmentStatusExternalId": "sample string 18",
"alreadySent": true,
"appointmentExternalId": "sample string 20",
"targetObjectExternalId": "sample string 21"
},
{
"patientCommunicationID": "b5529f74-0f34-4102-aa93-f04be748e454",
"accountName": "sample string 2",
"created": "2026-07-14T01:55:48.0369346+00:00",
"createdUtc": "2026-07-14T01:55:48.0369346+00:00",
"method": "sample string 5",
"type": "sample string 6",
"status": "sample string 7",
"allowToCancelAppointmentsDuringCommunications": true,
"from": "sample string 9",
"to": "sample string 10",
"messageSubject": "sample string 11",
"messageBody": "sample string 12",
"messageVoiceHuman": "sample string 13",
"messageVoiceMachine": "sample string 14",
"outgoing": true,
"locationPhoneNumber": "sample string 16",
"patientExternalId": "sample string 17",
"eyewearReadySetToStatusId": "dc3ef02f-3bec-4053-b301-ccb7706290ce",
"appointmentStatusExternalId": "sample string 18",
"alreadySent": true,
"appointmentExternalId": "sample string 20",
"targetObjectExternalId": "sample string 21"
}
]
}
application/xml, text/xml
Sample:
<ListModelOfPatientCommunicationModel0t6xyKmJ xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/GlobalPortal.Api.Models">
<CurrentPage>3</CurrentPage>
<FirstRowOnPage>5</FirstRowOnPage>
<ItemsPerPage>2</ItemsPerPage>
<LastRowOnPage>6</LastRowOnPage>
<Rows xmlns:d2p1="http://schemas.datacontract.org/2004/07/GlobalPortal.Api.Models.PatientCommunications">
<d2p1:PatientCommunicationModel>
<d2p1:AccountName>sample string 2</d2p1:AccountName>
<d2p1:AllowToCancelAppointmentsDuringCommunications>true</d2p1:AllowToCancelAppointmentsDuringCommunications>
<d2p1:AlreadySent>true</d2p1:AlreadySent>
<d2p1:AppointmentExternalId>sample string 20</d2p1:AppointmentExternalId>
<d2p1:AppointmentStatusExternalId>sample string 18</d2p1:AppointmentStatusExternalId>
<d2p1:Created>2026-07-14T01:55:48.0369346+00:00</d2p1:Created>
<d2p1:CreatedUtc>2026-07-14T01:55:48.0369346+00:00</d2p1:CreatedUtc>
<d2p1:EyewearReadySetToStatusId>dc3ef02f-3bec-4053-b301-ccb7706290ce</d2p1:EyewearReadySetToStatusId>
<d2p1:From>sample string 9</d2p1:From>
<d2p1:LocationPhoneNumber>sample string 16</d2p1:LocationPhoneNumber>
<d2p1:MessageBody>sample string 12</d2p1:MessageBody>
<d2p1:MessageSubject>sample string 11</d2p1:MessageSubject>
<d2p1:MessageVoiceHuman>sample string 13</d2p1:MessageVoiceHuman>
<d2p1:MessageVoiceMachine>sample string 14</d2p1:MessageVoiceMachine>
<d2p1:Method>sample string 5</d2p1:Method>
<d2p1:Outgoing>true</d2p1:Outgoing>
<d2p1:PatientCommunicationID>b5529f74-0f34-4102-aa93-f04be748e454</d2p1:PatientCommunicationID>
<d2p1:PatientExternalId>sample string 17</d2p1:PatientExternalId>
<d2p1:Status>sample string 7</d2p1:Status>
<d2p1:TargetObjectExternalId>sample string 21</d2p1:TargetObjectExternalId>
<d2p1:To>sample string 10</d2p1:To>
<d2p1:Type>sample string 6</d2p1:Type>
</d2p1:PatientCommunicationModel>
<d2p1:PatientCommunicationModel>
<d2p1:AccountName>sample string 2</d2p1:AccountName>
<d2p1:AllowToCancelAppointmentsDuringCommunications>true</d2p1:AllowToCancelAppointmentsDuringCommunications>
<d2p1:AlreadySent>true</d2p1:AlreadySent>
<d2p1:AppointmentExternalId>sample string 20</d2p1:AppointmentExternalId>
<d2p1:AppointmentStatusExternalId>sample string 18</d2p1:AppointmentStatusExternalId>
<d2p1:Created>2026-07-14T01:55:48.0369346+00:00</d2p1:Created>
<d2p1:CreatedUtc>2026-07-14T01:55:48.0369346+00:00</d2p1:CreatedUtc>
<d2p1:EyewearReadySetToStatusId>dc3ef02f-3bec-4053-b301-ccb7706290ce</d2p1:EyewearReadySetToStatusId>
<d2p1:From>sample string 9</d2p1:From>
<d2p1:LocationPhoneNumber>sample string 16</d2p1:LocationPhoneNumber>
<d2p1:MessageBody>sample string 12</d2p1:MessageBody>
<d2p1:MessageSubject>sample string 11</d2p1:MessageSubject>
<d2p1:MessageVoiceHuman>sample string 13</d2p1:MessageVoiceHuman>
<d2p1:MessageVoiceMachine>sample string 14</d2p1:MessageVoiceMachine>
<d2p1:Method>sample string 5</d2p1:Method>
<d2p1:Outgoing>true</d2p1:Outgoing>
<d2p1:PatientCommunicationID>b5529f74-0f34-4102-aa93-f04be748e454</d2p1:PatientCommunicationID>
<d2p1:PatientExternalId>sample string 17</d2p1:PatientExternalId>
<d2p1:Status>sample string 7</d2p1:Status>
<d2p1:TargetObjectExternalId>sample string 21</d2p1:TargetObjectExternalId>
<d2p1:To>sample string 10</d2p1:To>
<d2p1:Type>sample string 6</d2p1:Type>
</d2p1:PatientCommunicationModel>
</Rows>
<TotalItems>1</TotalItems>
<TotalPages>4</TotalPages>
</ListModelOfPatientCommunicationModel0t6xyKmJ>