The Ryan White HIV/AIDS Program Services Report (RSR) is the HRSA HIV/AIDS Bureau’s client-level data reporting system. All (Parts A through F) funded recipients (grantees) and sub-recipients (providers) must submit an RSR data report each year via the Electronic Handbooks.
Key Guides and Manuals
RSR Instruction Manual: this is the final, 508-compliant 2025 RSR Instruction Manual. Updated February 2026
RSR Schema Implementation Guide and Data Dictionary Updated October 2025
RSR TA Brochure and Timeline: this brochure outlines technical assistance and training available to Ryan White grantees for the Ryan White Services Report (RSR). It also includes the RSR submission timeline. Updated September 2026
TRAX Resources
Using TRAX to Create Your RSR Client-Level Data File: this document provides information on how to use TRAX to create the RSR Client-Level Data File. Included are resources to get a better understanding of the RSR’s required data elements and where to locate them in your data system (s). The document also includes some common issues TRAX users encounter and how to resolve them. Updated November 2025
TRAX Application Manual: a manual that outlines the basics of creating an XML file for the RSR with TRAX. Updated March 2026
TRAX Application Package and Manual: a suite of resources that includes:
- CHEX (updated February 2026)
- RSR Crosswalk (updated October 2025)
- TRAX Sample Files (updated September 2026)
- Blank Template Files (updated March 2026)
- TRAX Application Manual (updated October 2025)
In Focus Guides
The following In Focus guides serve as tools to walk users through some common functions associated with preparing and submitting the RSR:
RSR eUCI: guidelines for creating and encrypting the Unique Client Identifier (eUCI). Encryption of the eUCI must be included in the Ryan White Services Report (RSR) and ADAP Data Report (ADR) client-level data XML files. Updated November 2025
RSR Upload Completeness Report: information on how to use the Upload Completeness Report (UCR). This becomes available in the RSR Web System once client level data is uploaded. Updated December 2025
RSR Validations for Client-Level Data: summary of RSR validation checks initiated upon upload of a client level data report, including what triggers an Error, Warning, or Alert during the data validation process. Updated November 2025
Reporting Services Correctly in the RSR: this In Focus document provides guidance regarding how to ensure that CLD accurately reflects the services for which providers were funded. It was primarily developed to support services providers that are direct recipients of RWHAP funding from the Health Resources and Services Administration HIV/AIDS Bureau (HRSA HAB). Updated November 2025
RSR Provider Report: Clients by ZIP Code: this RSR In Focus provides guidance on the ZIP Code requirement and strategies for creating the report. Updated November 2026
Understanding the Policy Clarification Notice (PCN) 16-02: summary of changes that may affect your data management and reporting practices in relation to Policy Clarification Notice (PCN) #16-02 on Ryan White HIV/AIDS Program (RWHAP) client eligibility and program guidance for allowable service categories. Updated March 2022
Understanding Eligible Services Reporting: description of the Eligible Services reporting requirement for the RSR. Updated November 2025
eLearning Modules
Introduction to the RSR: New Staff Training Module: this self-paced, interactive module is intended to orient staff new to the Ryan White HIV/AIDS Program (RWHAP) and/or the Ryan White HIV/AIDS Program Services Report (RSR). It will provide an overview of data management strategies, RSR reporting requirements, and steps for submission. Last updated in 2022
RSR Upload Completeness Report Training Module: the RSR Upload Completeness Report (UCR) is a report generated by the RSR Web System that reads your uploaded XML file(s) and generates a report that shows you the full breakdown of your client-level data (CLD). The UCR is one of the most helpful tools in the Electronic Handbooks (EHBs) to help you ensure complete, high-quality data for your RSR. This self-paced module will teach you:
- How to upload data to the RSR Provider Report and Check Your XML Feature in the EHBs
- How to access the UCR
- How to read and interpret the UCR tables
- How to identify issues in your data using the UCR
- What to do if you identify a data issue
Last updated in 2021
Other Resources
RSR Validation Report All System Validation Messages: data validation checks related to the RSR Recipient Report, Provider Report, and client-level data file. This file lists the 2025 messages. Updated October 2025
Appendix A: Required Client-Level Data Elements for RWHAP Services: this resource is an excerpt from the RSR Instruction Manual. Updated January 2026
RSR Crosswalk: table for use by providers in creating their Ryan White Services Reports (RSRs) from their electronic health records (EHR) - specifically, to crosswalk EHR and RSR data elements. Updated October 2025
RSR-Ready Data Systems Vendor Information: many software systems, including EHRs, lab systems and case management systems, generate the RSR. These systems also have internal validations and reports that allow the provider to check the quality and completeness of the RSR data before upload. This document presents a table with the following information about the various RSR-Ready Systems:
- Build Number
- Number of users in the most recent submission
- Vendor websites and contact information
- Release timing of versions that create a compliant file for the upcoming submission
For more information about a particular data system, please contact the appropriate data system vendor. For general questions about selecting an RSR-Ready System, email the DISQ team. Updated December 2025
eUCI Application User Guide: the encrypted Unique Client Identifier (eUCI) and its application in RWHAP data systems. Updated October 2025
eUCI Generator: this ZIP file contains the eUCI executable file and the associated DLL. The executable file is an external application that allows providers to generate eUCIs by importing a .CSV file containing the required eUCI components (first and last name, full date of birth, and sex at birth code). The DLL can be used by developers of RSR-Ready and ADR-Ready systems, as well as by recipients or providers with large data systems, to embed eUCI generation directly within their systems. Updated November 2025