Querying and Reporting XML Service (QRXS)
QRXS Quick Links:
- Requirements and Specifications
- QRXS Test Environment
- Fact Sheet on the QRXS

- QRXS FAQs
- QRXS Mailing List
The QRXS is ideal for queriers and reporters who store and manage their subject and report data within their own information or credentialing systems. The QRXS automates query and report submissions to the Data Banks and returns responses in a format that can be easily loaded into users' information systems.
The QRXS is the Data Banks’ next generation interface, offering a number of benefits over the legacy ITP (Interface Control Document (ICD) Transfer Program) interface:
- QRXS users are offered two options for transmitting and downloading files: the QRXS Client Program Java Application Programming Interface (API) and the QRXS web service. Either option allows for an easy integration with users’ information and credentialing systems.
- The QRXS uses the standards-based eXtensible Markup Language (XML) format to submit and download data. The XML format is documented in XML Schemas provided by the Data Banks. The XML Schemas can be used with a binding technology to easily create (marshal) an XML file from data objects and parse and load (unmarshal) data from XML files to data objects. The XML Schemas can be used with an XML validator to verify that XML submission files are formatted correctly prior to submission. The XML technology enables a more flexible interface that is more cost effective to enhance and maintain than the ITP.
- Queries and reports submitted using the QRXS will be validated in real-time to ensure they meet the mandatory data requirements. If the data does not pass validation, a response file documenting the errors is immediately returned to the submitter; in contrast to the 2 to 4 hour ITP response time.
| Feature | QRXS | ITP |
|---|---|---|
| Client Program Java API |
Yes | No |
| Web Service Available |
Yes | No |
| Standards-Based XML File Format | Yes | No |
| Enables File Format Validation Prior to Submission |
Yes | No |
| Yes | No | |
| Enables Automatic XML File Creation and Processing |
Yes | No |
| Real-Time Data Validation Upon Submission |
Yes | No |
| Transaction Support: | ||
| Querying | Yes | Yes |
| No Charge for Queries Rejected Due to Data Errors | Yes | No |
| Report Change Notifications | Yes | No |
| Corrected Fields Indicated on Correction Reports | Yes | No |
| Password Changes | Yes | Yes |
| Report Submission (AAR, MMPR, JOCR) | Yes | Yes |
| Proactive Disclosure Service Prototype (PDS) | Yes | Yes |
QRXS transactions must be submitted in an XML document that conforms to the schemas written in the W3C XML Schema Language (version 1.0) provided in the QRXS File Format Specifications. Submission files should be checked for schema compliance prior to submission using a third-party XML Schema validator.
Successful response files will be available for download within an average of 2 to 4 hours of receipt by the Data Banks. Under certain circumstances, additional processing time may be required. Please do not re-submit your report or query on the subject in question, since this will result in duplicate transactions. If your submission file is not formatted properly following the specifications, it will be rejected. If you do not receive your response within 2 business days of submission, please contact the Customer Service Center.
Using the QRXS interface requires:
1. |
QRXS Client Program Resources:
|
2. |
QRXS Web Service Resources (an alternative to the QRXS Client Program): |
3. |
QRXS File Format Specifications (Sign In Required) |
|
The QRXS file format is defined by an XML ICD and an XML schema. The XML schema defines the structure and format of QRXS submission and response files. This schema is intended to be used by the technical staff who creates the functionality to format and process QRXS submission and response files. The XML ICD provides high level guidance to help users provide complete information for file submissions and for processing response files. The Data Banks strongly recommend the use of an XML validator to ensure that your XML files are correctly formatted prior to submission. There are many commercial and open-source XML validators available. The Data Banks may not be able to process submission files that do not satisfy the XML schema. Sample XML submission and response files are provided as part of the specifications. |
|
4. |
|
|
To ensure that your data files are well-formed, meet the mandatory data requirements, and sent successfully, use the QRXS test environment. Do not use the test environment for final submission of files. For information about how to access the QRXS test environment, see the following: |
|
5. |
Registration for the QRXS Mailing List: |
|
The QRXS file format is updated periodically by the Data Banks. It is strongly recommended that users join the QRXS Mailing List to receive notice of updates. The Data Banks make an effort to notify users at least 1 month in advance of an update to code lists. Users should expect code lists to be updated quarterly. Additional updates to the QRXS file formats are required periodically. Users will be notified 6 months in advance of updates to the QRXS file formats. |
|
6. |
QRXS users are encouraged to use the sample response files to format their response data. |
Healthcare Integrity and Protection Data Bank