Participant

Gets or sets data corresponding to Particpant records.

APIDescription
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.

APIDescription
POST Api/Medication

Create/Update a patient medication.

POST Api/Medication/Put

Create/Update a patient medication.

DeviceVitals

APIDescription
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

APIDescription
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.

APIDescription
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

APIDescription
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

APIDescription
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

APIDescription
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.

APIDescription
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.

APIDescription
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.

APIDescription
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.

APIDescription
GET Api/Reports?accountName={accountName}&fromDate={fromDate}&toDate={toDate}&isLessThan={isLessThan}&greaterThanLessThanValue={greaterThanLessThanValue}

Runs the CM CPT Report.

GET Api/Reports/GetCMCPTReport?accountName={accountName}&fromDate={fromDate}&toDate={toDate}&isLessThan={isLessThan}&greaterThanLessThanValue={greaterThanLessThanValue}

Runs the CM CPT Report.

ParticipantInterface

Gets or sets data corresponding to Particpant records.

APIDescription
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

APIDescription
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.

APIDescription
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.

APIDescription
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

APIDescription
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

APIDescription
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.