Participant
Gets or sets data corresponding to Particpant records.
API | Description |
---|---|
GET Api/Participant?alert_id={alert_id} |
This method will return participant details based on the alert_id. |
GET Api/Participant?provider_unique_id={provider_unique_id} |
This method will return participant details based on the provider_unique_id. |
POST Api/Participant |
This method allows a provider to update an existing participant record using the AlertID (unique id of the participant as assigned by TouchPointCare). All fields other than AlertID are optional. Only provide the fields you would like to update. |
GET Api/Participant/GetByAlertID?alert_id={alert_id} |
This method will return participant details based on the alert_id. |
GET Api/Participant/GetByProviderUniqueID?provider_unique_id={provider_unique_id} |
This method will return participant details based on the provider_unique_id. |
POST Api/Participant/Put |
This method allows a provider to update an existing participant record using the AlertID (unique id of the participant as assigned by TouchPointCare). All fields other than AlertID are optional. Only provide the fields you would like to update. |
Medication
Gets or sets data corresponding to medications records.
API | Description |
---|---|
POST Api/Medication |
Create/Update a patient medication. |
POST Api/Medication/Put |
Create/Update a patient medication. |
DeviceVitals
API | Description |
---|---|
POST Api/DeviceVitals |
This method allows a provider to add vitals readings to the TouchPointCare repository. To post a reading to TouchPointCare: (1) Authenticate and get a token as described in the "Getting Started" section of this guide. (2) Post the vitals reading data in the JSON or XML format described below. The provider_unique_id is required in order to find a matching participant in TouchPointCare. This ID must be assigned on the participant profile in TouchPointCare or you will receive an error message. See the list of error numbers below. |
POST Api/DeviceVitals/Put |
This method allows a provider to add vitals readings to the TouchPointCare repository. To post a reading to TouchPointCare: (1) Authenticate and get a token as described in the "Getting Started" section of this guide. (2) Post the vitals reading data in the JSON or XML format described below. The provider_unique_id is required in order to find a matching participant in TouchPointCare. This ID must be assigned on the participant profile in TouchPointCare or you will receive an error message. See the list of error numbers below. |
ParticipantDevice
API | Description |
---|---|
POST Api/ParticipantDevice |
This method allows a provider to assign a device to a participant. |
POST Api/ParticipantDevice/Put |
This method allows a provider to assign a device to a participant. |
Results
Results Controller.
API | Description |
---|---|
GET Api/Results?fromDate={fromDate}&toDate={toDate}&accountName={accountName} |
Returns the telehealth question and vitals data for a given date range and (optional) account name. This data is the same as is available via the "Call Data Export" report in TouchPointCare. |
GET Api/Results?scheduleId={scheduleId}&filterType={filterType} |
This method will return participant vitals and telelealth data that has not yet been flagged and having been received. |
GET Api/Results?custom1={custom1}&filterType={filterType}&ignoreCommentNotes={ignoreCommentNotes} |
This method will return a list of scheduled TouchPoints that have not yet been flagged as sent to the provider. |
GET Api/Results?alertId={alertId}&fromDate={fromDate}&toDate={toDate} |
This method will return all participant result data for a given participant (alert id) and date range (fromDate to toDate). This method should be used in conjunction with the GetParticipantsWithResultsByDate endpoint which will return a list of alert IDs. |
POST Api/Results?filterType={filterType} |
This method will return participant vitals and telelealth data that has not yet been flagged and having been received. |
POST Api/Results |
This method allows a provider to add data results to the TouchPointCare repository. To post a result to TouchPointCare: (1) Authenticate and get a token as described in the "Getting Started" section of this guide. (2) Post the results data in the JSON or XML format described below. The provider_unique_id OR mobilehelp_device_id is required in order to find a matching participant in TouchPointCare. These IDs must be assigned on the participant profile in TouchPointCare or you will receive an error message. See the list of error numbers below. |
GET Api/Results/Get?fromDate={fromDate}&toDate={toDate} |
This method will return patient response data for the given date range (from/to date). |
GET Api/Results/GetResponses?fromDate={fromDate}&toDate={toDate}&accountName={accountName} |
Returns the telehealth question and vitals data for a given date range and (optional) account name. This data is the same as is available via the "Call Data Export" report in TouchPointCare. |
GET Api/Results/GetUnsentDataByTouchPoint?scheduleId={scheduleId}&filterType={filterType} |
This method will return participant vitals and telelealth data that has not yet been flagged and having been received. |
GET Api/Results/GetUnsentTouchPoints?custom1={custom1}&filterType={filterType}&ignoreCommentNotes={ignoreCommentNotes} |
This method will return a list of scheduled TouchPoints that have not yet been flagged as sent to the provider. |
GET Api/Results/GetParticipantsWithResultsByDate?fromDate={fromDate}&toDate={toDate} |
This method will return a list of participant ids (alert ids) that have results data during the given date range. <param name="fromDate">The beginning date to find participants with results.</param><param name="toDate">The ending date to find participants with results.</param>". |
GET Api/Results/GetByParticipantAndDate?alertId={alertId}&fromDate={fromDate}&toDate={toDate} |
This method will return all participant result data for a given participant (alert id) and date range (fromDate to toDate). This method should be used in conjunction with the GetParticipantsWithResultsByDate endpoint which will return a list of alert IDs. |
POST Api/Results/MarkAsSent?filterType={filterType} |
This method will return participant vitals and telelealth data that has not yet been flagged and having been received. |
POST Api/Results/Put |
This method allows a provider to add data results to the TouchPointCare repository. To post a result to TouchPointCare: (1) Authenticate and get a token as described in the "Getting Started" section of this guide. (2) Post the results data in the JSON or XML format described below. The provider_unique_id OR mobilehelp_device_id is required in order to find a matching participant in TouchPointCare. These IDs must be assigned on the participant profile in TouchPointCare or you will receive an error message. See the list of error numbers below. |
GET Api/Results?fromDate={fromDate}&toDate={toDate} |
This method will return patient response data for the given date range (from/to date). |
ParticipantVitalAlert
Get or sets Participant Vital Alert Data
API | Description |
---|---|
GET Api/ParticipantVitalAlert?alert_id={alert_id}&vital_type={vital_type} |
This method finds a particpant level alert for a particpant and vital sign. |
POST Api/ParticipantVitalAlert |
This method allows a provider to insert or update an existing participant record using the Alert ID (unique id assigned by TPC) or the Participant ID (unique id assigned by the provider). You can also add the participant to groups subsequently kicking off any associated TouchPoints. |
GET Api/ParticipantVitalAlert/Get?alert_id={alert_id}&vital_type={vital_type} |
This method finds a particpant level alert for a particpant and vital sign. |
POST Api/ParticipantVitalAlert/Put |
This method allows a provider to insert or update an existing participant record using the Alert ID (unique id assigned by TPC) or the Participant ID (unique id assigned by the provider). You can also add the participant to groups subsequently kicking off any associated TouchPoints. |
MobileHelp
API | Description |
---|---|
POST Api/MobileHelp |
This method allows MobileHelp to post vitals gathered via MobileHelp devices on behalf of a provider. |
POST Api/MobileHelp/Put |
This method allows MobileHelp to post vitals gathered via MobileHelp devices on behalf of a provider. |
ParticipantGroup
API | Description |
---|---|
POST Api/ParticipantGroup |
This api method will add or remove a participant from a group. |
POST Api/ParticipantGroup/ChangeGroup |
This api method will add or remove a participant from a group. |
User
Gets or sets data corresponding to users of the TouchPointCare application.
API | Description |
---|---|
POST Api/User |
This method allows a provider to insert or update an existing participant record using the Alert ID (unique id assigned by TPC) or the Participant ID (unique id assigned by the provider). You can also add the participant to groups subsequently kicking off any associated TouchPoints. Error Codes returned: 901 - Account improperly setup, 902 - Invalid Account Name, 903 - Invalid access level name, 920 - Unauthorized to use this endpoint. |
POST Api/User/Put |
This method allows a provider to insert or update an existing participant record using the Alert ID (unique id assigned by TPC) or the Participant ID (unique id assigned by the provider). You can also add the participant to groups subsequently kicking off any associated TouchPoints. Error Codes returned: 901 - Account improperly setup, 902 - Invalid Account Name, 903 - Invalid access level name, 920 - Unauthorized to use this endpoint. |
Contacts
Gets or sets data corresponding to Provider Contact records.
API | Description |
---|---|
GET Api/Contacts?accountName={accountName} |
The api/Contacts method will get a list of all Contacts (case managers) for the specified account. <param name="accountName">The account name matching a child account of the provider. </param> |
GET Api/Contacts |
The api/Contacts method will get a list of all Contacts (case managers) for the provider account. |
GET Api/Contacts/Get?accountName={accountName} |
The api/Contacts method will get a list of all Contacts (case managers) for the specified account. <param name="accountName">The account name matching a child account of the provider. </param> |
GET Api/Contacts/Get |
The api/Contacts method will get a list of all Contacts (case managers) for the provider account. |
ParticipantFile
Gets or sets data corresponding to files on a participant records.
API | Description |
---|---|
POST Api/ParticipantFile?provider_unique_id={provider_unique_id}&alert_id={alert_id} |
This method will return post a file to a participant's profile. The file must of the following extensions: .xls, xlsx, .doc, .docx, |
POST Api/ParticipantFile/PostFile?provider_unique_id={provider_unique_id}&alert_id={alert_id} |
This method will return post a file to a participant's profile. The file must of the following extensions: .xls, xlsx, .doc, .docx, |
Reports
Collection of methods used to run various reports.
ParticipantInterface
Gets or sets data corresponding to Particpant records.
API | Description |
---|---|
POST Api/ParticipantInterface |
This method allows a provider to insert or update an existing participant record using the Alert ID (unique id assigned by TPC) or the Participant ID (unique id assigned by the provider). You can also add the participant to groups subsequently kicking off any associated TouchPoints. |
POST Api/ParticipantInterface/Put |
This method allows a provider to insert or update an existing participant record using the Alert ID (unique id assigned by TPC) or the Participant ID (unique id assigned by the provider). You can also add the participant to groups subsequently kicking off any associated TouchPoints. |
Series
API | Description |
---|---|
GET Api/Series |
The api/series method will get a list of all question series for the account. |
GET Api/Series/Get |
The api/series method will get a list of all question series for the account. |
Actions
These API endpoints are used to retrieve "Call Actions"/events on a scheduled TouchPoint instance. Events include: attempting outbound IVR call, SMS Message Sent, SMS Message received, Busy, No Answer, Voice Mail, and more.
API | Description |
---|---|
GET Api/Actions?startDate={startDate}&endDate={endDate} |
No documentation available. |
GET Api/Actions/Get?startDate={startDate}&endDate={endDate} |
No documentation available. |
ResultsTest
Results Controller. Used specifically for testing. All data entered via this endpoint will be deleted immediately.
API | Description |
---|---|
POST Api/ResultsTest |
For TESTING ONLY. All data added via this endpoint will be deleted immediately. This method allows a provider to add data results to the TouchPointCare repository. To post a result to TouchPointCare: (1) Authenticate and get a token as described in the "Getting Started" section of this guide. (2) Post the results data in the JSON or XML format described below. The provider_unique_id OR mobilehelp_device_id is required in order to find a matching participant in TouchPointCare. These IDs must be assigned on the participant profile in TouchPointCare or you will receive an error message. See the list of error numbers below. |
POST Api/ResultsTest/Put |
For TESTING ONLY. All data added via this endpoint will be deleted immediately. This method allows a provider to add data results to the TouchPointCare repository. To post a result to TouchPointCare: (1) Authenticate and get a token as described in the "Getting Started" section of this guide. (2) Post the results data in the JSON or XML format described below. The provider_unique_id OR mobilehelp_device_id is required in order to find a matching participant in TouchPointCare. These IDs must be assigned on the participant profile in TouchPointCare or you will receive an error message. See the list of error numbers below. |
DeviceExtendedData
API | Description |
---|---|
POST Api/DeviceExtendedData |
This method allows a device provider to transfer device specific extended data. Examples include low battery alerts, steps for the day, etc. |
POST Api/DeviceExtendedData/Put |
This method allows a device provider to transfer device specific extended data. Examples include low battery alerts, steps for the day, etc. |
TouchPoint
API | Description |
---|---|
GET Api/TouchPoint/GetNextQuestion?schedule_id={schedule_id} |
The api/TouchPoint/GetNextQuestion method will lookup the TouchPoint instance by the schedule_id and return the next question that has not yet been answered. |
GET Api/TouchPoint/Get?schedule_id={schedule_id} |
The api/TouchPoint method will lookup the TouchPoint instance by the schedule_id and return the next question that has not yet been answered. This is the same as api/TouchPoint/GetNextQuestion. |
GET Api/TouchPoint?schedule_id={schedule_id} |
The api/TouchPoint method will lookup the TouchPoint instance by the schedule_id and return the next question that has not yet been answered. This is the same as api/TouchPoint/GetNextQuestion. |