iSalusExternal.GetPatientFilterIdentifiers

Overview

The iSalusExternal.GetPatientFilterIdentifiers webservice is used to obtain a list of patient IDs. The patient's returned in the response represent patients that have had various data elements updated within their chart, during the specific timeframe. This includes updates/changes to Demographics, Problem Lists, eDocuments, and Claims. When making a request, date parameters can be provided to narrow the results and allows the vendor to determine their own call cadence.

The expectation with the webservice response is that the vendor then calls the GetPatientFilterData method with the Patient IDs to obtain the content of the patient record.

Sample Call

Request

<request>
    <security>
        <key>REDACTED</key>
        <version>1.0</version>
        <account>REDACTED</account>
    </security>
    <start_date>01/01/1901 01:00am</start_date>
    <end_date>01/01/3001 01:00am</end_date>
    <page_number>1</page_number>
    <page_total>1</page_total>
</request>

Response

<response xmlns="http://www.isalushealthcare.webservices/">
    <patient_list>
        <patient_id>9329</patient_id>
        <patient_id>9333</patient_id>
        <patient_id>9334</patient_id>
        <patient_id>9336</patient_id>
        <patient_id>9337</patient_id>
        <patient_id>9339</patient_id>
        <patient_id>9340</patient_id>
        <patient_id>9341</patient_id>
        <patient_id>9342</patient_id>
        <patient_id>9343</patient_id>
        <patient_id>9344</patient_id>
        <patient_id>9345</patient_id>
        <patient_id>9346</patient_id>
        <patient_id>9347</patient_id>
        <patient_id>9348</patient_id>
        <patient_id>9349</patient_id>
        <patient_id>9350</patient_id>
        <patient_id>9351</patient_id>
        <patient_id>9352</patient_id>
        <patient_id>9353</patient_id>
        <patient_id>9354</patient_id>
    </patient_list>
</respons

Element Description

Request

The Request element will serve as a wrapper for the entire body of the XML request.

Request > Security

See documentation for the Security node here:  Access to Webservices

Request > Start_Date

This date represents the date that the patient data was modified. Not including this element will cause the method to return data starting from 01/01/1901 to today.

Request > End_Date

This represents the end of the date range that patient data was modified. Not including this element will cause the method to return data ending 01/01/3001.

Request > Page_Number

Optionally you may provide a page_number, this works in conjunction with the page_total. The page number defines which page of the requested set to return.

Request > Page_Total

Optionally you may provide a page_total, this works in conjunction with the page_number. The page total defines the max number of patients to be returned on a page.

Response

The Response element will serve as a wrapper for the entire body of the XML response.

Response > patient_list

This will serve as a wrapper for all patient identifiers.

Response > patient_list > patient_id

This repeating node will contain a numeric patient_id to be stored and used within the subsequent call for GetPatientFilterData.