Contact Us

HR-JON and HR-XML Standards Libraries

Download The Standards

Our standards are free, current, global HR data vocabularies developed in a transparent, collaborative, consensus-based environment open to all HR professionals and organizations.

The following versions of HR Open Standards are available for free public download. You need to be logged in to download the standards, but don't worry registration is a breeze. If you're not already an HR Open Standards member, you can register for a free Community membership account. By downloading the HR Open Standards you are agreeing to the
HR Open Standards IP Agreement.


Note that full release downloads are no longer available for 3.2 and above. For questions regarding this, please contact us. Access to standards work-in-progress and the HR Open Standards repository is member exclusive benefit.Learn about other HR Open Standards member benefits.
Candidate Release

HR-JSON Library

4.1 HR-JSON Specification (Candidate)

Included in candidate release:

  • Assessments JSON schema
  • Benefits JSON schema
  • Common JSON schema
  • Compensation JSON schema
  • Recruiting JSON schema
  • Timecard JSON schema
  • Wellness
  • Sample JSON Files

The Common folder includes:

  • Shared JSON Components and Code Lists

Candidate releases have not been approved by the Consortium membership. The purpose of the candidate release is to allow early access and feedback for these beta specifications.

Timecard HR-JSON Specification (Candidate)

Included in candidate release:

  • Timecard JSON schema
  • Common
  • Sample JSON Files
  • Use Case Documentation

The Common folder includes:

  • Shared JSON Components and Code Lists
  • Best Practices and General Documentation
  • Instructions for Workgroup Development

Candidate releases have not been approved by the Consortium membership. The purpose of the candidate release is to allow early access and feedback for these beta specifications.

Wellness HR-JSON Specification (Candidate)

Included in candidate release:

  • Wellness JSON schema
  • Common
  • Sample JSON Files
  • Use Case Documentation

The Common folder includes:

  • Shared JSON Components and Code Lists
  • Best Practices and General Documentation
  • Instructions for Workgroup Development

Candidate releases have not been approved by the Consortium membership. The purpose of the candidate release is to allow early access and feedback for these beta specifications.

Approved Releases

HR-XML Library

Assessments HR-XML Specification

HR Open Standards Consortium assessment specification supports the procurement of assessment services and the integration of assessment results. An assessment of an individual may be required during the hiring process, development, and training, or promotion. This specification allows data exchange for these and other scenarios.
The assessment standards include:

  • AssessmentCatalog.Contains a set of information about assessment services or tests available to a customer.
  • AssessmentOrder. Defines a set of information necessary to execute an order for an employment test or assessment.
  • AssessmentReport. Provides scores and other details to fulfill or respond to an assessment order.

Benefits HR-XML Specification

HR Open Standards Consortium benefit specifications support the enrollment and management of a variety of benefit plans. The benefits download includes three specifications: US Benefits Enrollment, Savings Plan Enrollment, and Stock.

  • USBenefitsEnrollment. Supports enrollment in "tier-based" benefit coverages (such as medical, dental, and vision) and in spending accounts (for example, flexible spending accounts). As the name implies, the schema is designed around requirements principally found within the United States market.
  • SavingsPlanEnrollment. Provides a means to communicate information about participants' savings plan elections.

The stock specification includes:

  • StockPlanParticipant. Contains a collection of information about an account holder in a employer-sponsored stock option or stock purchase program.
  • StockDeposit. Contains instructions for the broker to distribute stock to a given set of participants. The broker receives a stock transfer by the ESPP sponsor company's transfer agent and therefore needs this instruction before distribution can take place.
  • StockPlan. Contains a collection of information relevant to creating and maintaining employee stock plan records. Supported plans are Stock Option, Stock Purchase Plans, and Stock Awards.
  • StockOptionExerciseOrder. Contains a collection of information relating to the exercise of a stock option award.
  • StockOptionExerciseConfirmation. Contains information communicated from a broker to a stock option plan administrator regarding the exercise of stock options by a program participant.
  • StockOptionGrant. Contains a collection of information relating to the award for an individual's option to purchase company stock shares.
  • StockSaleConfirmation. Contains details regarding the outcome of a stock sale. This noun typically would be used by a broker to accomplish certain required reporting back to the administrator of an employee stock purchase plan through which the sold shares were originally acquired.

Contingent Staffing HR-XML Specification

HR Open Standards Consortium contingent staffing specification enables the exchange of data between the contingent staffing industry's customers (hiring companies), intermediaries (vendor management services) and staffing agencies.

The staffing specification includes:

  • StaffingOrder. Contains a set of information sufficient to place and manage an order with a staffng supplier. May also be used in "request for quote" (RFQ) operations underwhich a customer seeks pricing and offer information from a supplier in connection with a "requisition."
  • StaffingResource.Contains information relating to a person proposed, or with which a staffing customer has contracted, to fulfill a staffed position or role.
  • StaffingAssignment. Conveys the set of terms and conditions related to the placement of a staffing resource with a staffing customer.
  • TimeCard. Allows the capture of time-worked data as well as information about associated expenses and allowances.
  • EmploymentEligibilityI-9.Contains the data completed by both the employee and employer on United States Form I-9.
  • WorkerOnBoarding. Used to onboard a person as an employee or contingent worker.

Employee Performance Management HR-XML Specification

Many enterprises recognize that the value of their employee performance management processes increases significantly when supporting EPM systems are well integrated with other talent management components. There are many possible integration scenarios among stakeholders, including detailed performance scores through a rolled up summary of objectives. These schemas support those transactions.
The Employee Performance Management specification includes:

  • DevelopmentPlan. Supports the communication of a training or development plan. A common use might be the transfer of training or learning information from a performance management system to a learning management system.
  • EPMPartipant. A collection of data relevant to enrolling a participant within an employee performance management program.
  • EPMRaterPanel. Contains a collection of information about individuals that are designated to serve as evaluators or "raters" within performance appraisal processes. Note that EPMParticipant may be used as an alternative to the EMPRaterPanel.
  • EPMResult. Defines a result from an employee performance management (EPM) process or "appraisal."
  • ObjectivesPlan. Supports the specification of objectives, groups of objectives, and related metrics and metadata. Used in integration of such systems as compensation management, business performance management, employee performance management, and project management systems.
  • ObjectivesResult. Contains information about results, against an objective plan.

Payroll HR-XML Specification

HR Open Standards Consortium payroll specification supports the setup of a worker in the Payroll system. It assumes the company information has already been set up.

  • PayrollMasterData. Provides the structure necessary for adding a new worker into the payroll system, including payment details, deductions, garnishments and taxes. This first release includes localizations for the United States, Canada, and Netherlands.

Provisioning HR-XML Specification

HR Open Standards Consortium provisioning specification supports data exchange to provision HR Information and 3rd party systems.

The provisioning specification includes:

  • IndicativeData. Defines a set of data about the relationship between an employer and employee or former employee that is relevant to the provisioning of outsourced benefits and payroll systems.
  • HRMasterData. Contains a broad set of information about a human resource, which may be used to provision or synchronize data between and among HR systems.
  • UserAccount. Contains a set of information used to establish and maintain user accounts for an application or system.
  • OrganizationChart. Provides a simple, "open model" structure for communicating basic information about an organization, its sub-entities or "organization units," the positions within those units, and the incumbents within those positions.
  • CompetencyDefinitions. Contains structured information about the semantics associated with a one or more competencies.
  • PositionCompetencyModel.Contains a collection of competency information associated with a position or job.

Recruiting HR-XML Specification

HR Open Standards Consortium recruiting specifications support the processes for recruiting and onboarding an employee. These may include data exchanged between a recruiter, job board, candidate, and HRIS, as well as other trading partners.
The recruiting specifications may include:

  • PositionOpening. Contains details about a position opening, including requirements for the position as well as administrative information, such as how to apply.
  • Candidate.Defines a set of information about an applicant or prospective employee or resource. Like a resume, a Candidate document contains details about a person's education and professional experience. However, Candidate may include data that is not typically included on a Resume, such as remuneration requirements and various position preferences.
  • SearchDocument. Provides a way for one system, such as an ATS, to request matching documents for a query against another system, such as a Job Board or a Resume Bank.
  • ApplicationForm. Includes information for candidate to enter information for an application.
  • EmploymentEligibilityI-9. Contains the data completed by both the employee and employer on United States Form I-9.
  • WorkerOnBoarding.Used to onboard a person as an employee or contingent worker.

Screening HR-XML Specification

Over 70% of companies in the United States utilize background screening as part of their hiring / vetting process for their applicants. In addition some companies performed re-screening of their employees on a period basis. The HR Open Standards Consortium's Screening specifications relate to data communications between end user companies / applicant tracking systems, Consumer Reporting Agency (CRA), and Providers. Providers are companies or individual researchers that are responsible for providing search results to the CRA’s.
The screening specification includes:

  • CreditResult. Contains information returned from a search from one or more consumer reporting or "credit bureaus." This is included in the Screening Order or may be used independently.
  • DrugTest. Contains information needed to request a drug or alcohol test, provide status of the request, and provide results of the test.
  • EmploymentEligibilityI-9. Contains the data completed by both the employee and employer on United States Form I-9.
  • ScreeningCatalogOrder. Contains descriptive information about available screening services or to check current availability or pricing.
  • ScreeningCatalogReport. Contains a set of information describing a screening service provider's catalog.
  • ScreeningOrder. Contains a set of information necessary to submit or administer screening requests to employment-screening service providers.
  • ScreeningReport. Contains a set of data fulfilling or relating to an employment screening order. This may be detailed, fielded information, a link to a location where results can be accessed securely, or embedded or attached documents.
  • ScreeningPackageOrder. This is a subset of the full ScreeningOrder. It is intended to support an "OrderByPackageID" scenario.
  • ScreeningPackageReport. Contains a set of data fulfilling or relating to an employment screening order.
  • ScreeningVendorOrder. Provides the data elements required by the Provider to run the appropriate criminal, civil or federal searches requested by the CRA.
  • ScreeningVendorReport. The response by the Provider to the Screening Vendor Order request.

Time Management HR-XML Specification

HR Open Standards Consortium time management specification enables the exchange of flexible time worked data, plus a simple format for the representation of expenses and allowances. HR-XML recommends implementing IndicativeData to provision Time and Attendance systems. See Provisioning specification for details.

  • TimeCard. Allows the capture of time-worked data as well as information about associated expenses and allowances.

Previous Libraries

HR-XML Library

3.1 Full HR-XML Release (2010-09-21)

This product contains a condensed file (.zip) for the full 3.1 HR-XML standards library.
Included for all Domains:

  • Readme file
  • Schema (Nouns and Common Files)
  • Business Object Documents (BODs)
  • Web Service Definition Language (WSDL patterns)
  • Instances (sample XML files)
  • Documentation (html)
  • 2.5 to 3.X mappings

Note: Version 3.1 is only available as a full download. Individual domain libraries are available in Version 3.2 and 3.3

3.0 Full HR-XML Release (2009-09-23)

This product contains a condensed file (.zip) for the full 3.0 HR-XML standards library.

Included for all Domains:

  • Readme file
  • Schema (Nouns and Common Files)
  • Business Object Documents (BODs)
  • Web Service Definition Language (WSDL patterns)
  • Instances (sample XML files)
  • Documentation (html)
  • 2.5 to 3.X mappings

  • Note: Version 3.0 is only available as a full download. Individual domain libraries are available in Version 3.2

2.6 Staffing Release (2015-05-01)

This product contains a condensed file (.zip) for the Staffing 2.6 HR-XML standards release.

Domains included:

  • Staffing Exchange Protocol (SEP)
  • Staffing Industry Data Exchange Standard (SIDES)
  • Cross-Process Objects (CPO)
  • Timecard

2.5 Full HR-XML Release (2007-04-15)

This product contains a condensed file (.zip) for the full 2.5 HR-XML standards library. Included for all Domains:

  • Readme file
  • Schema (Nouns and Common Files)
  • Instances (sample XML files)
  • Use Case Documentation

  • Note: Version 2.5 is only available as a full download. Individual domain libraries are available in Version 3.2.