Set up digital record retrieval

With digital record retrieval, you can perform these API actions while integrating with the Carequality Interoperability Framework:

• Search for a patient with demographics: Find organizations that have a record for your patient and obtain demographics and identifiers.
• Retrieve a patient's documents: Retrieve patient summaries and other clinical documents.

Before you can use these API actions though, you must complete some "pre-work" to set up digital record retrieval.

1. Log in to the Redox dashboard.
2. From the navigation menu, click the Digital Record Retrieval page.
3. In the Qualify for Carequality section, click the See if you qualify for Carequality... link.

   
4. A modal opens with the Carequality qualifications:
   1. In the Carequality Terms section, open and review the Carequality Connection Terms. Click the checkbox to confirm and accept the Carequality Connection Terms.

      Failing to comply with Carequality rules

      If you fail to comply with Carequality rules or falsely represent your purpose of use, your access to Carequality may be suspended. Talk to a Redoxer if you are concerned about complying with any of the rules above.

   2. Review the Purpose of Use Treatment section. If you meet the purpose of use, click the checkbox to assert that your organization qualifies for the permitted purpose of use.

      Treatment

      “Treatment” generally means the provision, coordination, or management of health care and related services by one or more health care providers, including the coordination or management of health care by a health care provider with a third party, consultation between health care providers relating to a patient, or the referral of a patient for health care from one health care provider to another.

   3. In the National Provider Identifier field, enter your National Provider ID (NPI) number. Your NPI is appended to all of your requests to search for patients within the Framework.
   4. In the Website field, enter your company's website address. We require this to approve your application.
   5. In the Redox Cloud Services Agreement, open and review the Cloud Services Agreement. Click the checkbox to confirm and accept.
5. Once you have filled out all the fields and certified all the terms in the modal, click the Submit button.
6. The modal closes, and in the Qualify for Carequality section, your approval status appears along with the submission date.

   

While you're waiting to be approved, you can go ahead and generate your credentials.

1. In the Credentials section, click the Generate credentials button.
2. The Credentials section populates with these values:
   1. Source identifier
   2. API key
   3. API secret
   4. Patient OID
   5. Organization OID
   6. Document OID
   7. Data on demand destination ID

You can use these credentials to test your integration with Carequality.

Now you're ready to perform technical validation. We provide a Postman collection and environment to use for testing.

1. In the Technical Validation section, click the Download Postman Collection button, then click the Download Postman Environment button.
2. Open Postman and import the downloaded collection and environment.

There are notes within the Postman collection to the right of most of the directories. These comments can help you decide between your options, explain the specific fields, and tell you what may change between production/staging environments or individual queries. The comments also indicate which environment variables change regularly. 

The values are found within the environment and include comments with the following prefixes:

To complete technical validation, you must send test messages to validate your system. Each of these tests are divided into their own how-to:

1. Create and maintain your organization record.
2. Search for patient records.
3. Request patient documents.
4. Maintain your Redox repository.