Set up Redox Access

With Redox Access™, 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 patient documents: Retrieve patient summaries and other clinical documents.

Before you can use these API actions, though, you must complete some "pre-work."

Before you can use Redox Access, you must qualify to be a Carequality participant. The qualifying process should begin before signing a contract with Redox. If you haven't qualified yet, reach out to your Redox sales rep to begin the qualifying process.

Carequality requires that you fill out a form prior to going live on the Carequality Framework. Organizations that meet the Treatment Purpose of Use will find the most value in joining since all participants must respond to your queries. Organizations with other Purposes of Use may join but may not receive responses from participants.

You'll work with Redox to set up the appropriate credentials and OIDs for working with Carequality. These are the things you'll need:

• source identifier
• API key
• API secret
• patient OID
• organization OID
• document OID
• data on demand destination ID

1. Create and authenticate an OAuth API key.
2. Refer to the API reference and complete dev work for using the relevant data models or FHIR® resources. You'll need these to query and write data to the Carequality Framework.
   • Data models
     • PatientSearch.Query
     • PatientSearch.LocationQuery
     • Organization.Query
     • Organization.New
     • Organization.Update
     • ClinicalSummary.PatientQuery
     • ClinicalSummary.DocumentQuery
     • ClinicalSummary.DocumentGet
     • ClinicalSummary.VisitQuery
     • ClinicalSummary.VisitPush
     • PatientAdmin.NewPatient
     • PatientAdmin.PatientUpdate
     • PatientAdmin.PatientMerge
   • FHIR® resources
     • Patient_search
     • DocumentReference_search
3. Submit a tech validation ticket to being the testing process described in the next section. Learn about submitting pre-production tickets to the Redox Help Desk.

1. Set up your data on demand destination that you can push data to.
2. Configure subscriptions to the Carequality Framework. You must have already created an OAuth API key for a Redoxer to complete this step.
3. Provide all identifiers, or OIDs, for testing. This includes these OIDs. You can use these to test your integration with Carequality.

During the setup process for Redox Access, you'll want to perform technical validation. We provide a Postman collection and environment to use for testing, which you can get from the Redox technical account manager.

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. We divide each of these tests 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.

When you're done with tech validation, submit a go-live readiness ticket so that we can help you migrate to production.

After migrating to production, make sure to push patient demographics and visit details to your data on demand repository. This allows us to respond to incoming requests from other Carequality participants.