Background Reports: Credit Report
Recommendation, 2006 Feb 28
Editors: Craig Corner, HireCheck; Chuck
Allen, HR-XML Consortium, Inc.
Contributors:
Brad Whitney, American Background; Sue Morgan, HireCheck; Paul Kiel, HR-XML Consortium, Inc.; Mark Sulimirski, ChoicePoint; Charles Rieckhoff, HireRight; Owen Wilson, Total Information Services, Inc.
Copyright statement
©2006 HR-XML. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of the publisher.
Abstract
This document contains the element definitions for the
HR-XML Consortium’s Credit Report schema (Credit.xsd). The schema is a
component of HR-XML’s Background Checking specification. For further
information on the Background Checking Specification, see:
http://ns.hr-xml.org/2_5/HR-XML-2_5/Screening/US/BackgroundChecking.html
Status of this Document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
Table of Contents
3.1 Design Requirements: Interoperability With Credit Bureau Formats
3.2 Schema Element Descriptions
3.2.17 MostRecentAdverseRating
4 Implementation Considerations
4.2 Laws Governing Credit Checks
5 Appendix A – Document Version History
6 Appendix B – Related Documents
Credit reports are frequently used as part of a background check. Credit reports can help verify basic facts about the search subject, including prior employers, addresses, and other names the search subject may have used. This information may be be used as input for other screenings, such as employment verification and criminal records searches. For example, identifying prior addresses can be important for deciding which courts to target for a criminal records search. Of course, credit reports also provide valuable insight into a job applicant’s financial responsibility. This may be particularly important if a position involves handling cash, responsibility for managing money, or similar fiduciary responsibilities.
There are several private “bureaus” that provide credit reports for employment screening purposes. Within the United States, Experian’s Employee Insight™, Equifax’s Persona™, and Trans Union’s PEER™ are the most widely used services. Each service makes its data available in its own proprietary format.
The HR-XML Consortium’s Credit Report schema is intended to be granular and sufficiently detailed to capture all of the credit data relevant to employment screening. In designing the schema, members of the HR-XML Consortium’s Screening workgroup reviewed the reports produced by each of the credit bureaus. They were careful to ensure that the HR-XML Consortium Credit Reports schema could accommodate all the relevant data fields from the credit bureau report formats. The HR-XML Consortium schema has been designed so that where necessary, the credit bureau’s codes, scoring, and scoring model identifiers can be passed through within an HR-XML Credit Report instance document.
Implementors should note that the Consortium’s Credit Report schema is not necessarily suitable for purposes other than employment screening. Consider that the Mortgage Industry Standards Maintenance Organization (see http://www.mismo.org) has developed an XML specification for the capture of credit-report details necessary for the processing of mortgage applications. The MISMO specification captures the set of credit-report data pertinent to mortgage processing in the same way that the HR-XML specification captures credit report data pertinent to employment screening.
Credit Bureau. An agency that provides credit and collection data on consumers within a particular time frame (usually measured in years). This data includes people's credit histories, and can be released in the form of credit reports.
Credit score. This term is used to refer to credit bureau risk scores. It broadly refers to a number generated by a statistical model that is used to objectively evaluate information that pertains to making a credit decision.
Equifax. One of the three major credit bureaus.
Experian. One of the three major major credit bureaus, formerly known as TRW.
Inquiry. Every time a lender requests a credit report, a notation is made on the consumer's record describing the lender, the type of request, and the date. The request is called an “inquiry” and is used to moniter consumer requests for credit.
Installment Loan. A credit account in which the amount of the payment and the number of payments are predetermined or fixed.
Public Record. Information obtained by the credit bureau from public court records, such as liens, bankruptcy filings, and judgments. Public records are open to any person who requests them.
Revolving Account. An account which requires at least a specified minimum payment each month plus a service charge on the balance. As the balance declines, the amount of the service charge, or interest, also declines.
Trans Union. One of the three major credit bureaus.
The HR-XML Consortium’s Credit Report schema was
designed as a component of the HR-XML Consortium’s Background Checking
specification. For a description and illustration of supported business
processes, see:
http://ns.hr-xml.org/2_5/HR-XML-2_5/Screening/US/BackgroundChecking.html
The Credit Reporting schema also could be used on a “stand-alone”
basis. For example, the schema might be useful in building interfaces between
“credit reporting engines” and employment screening service
providers.
The HR-XML Consortium Credit schema was designed as much as possible to be interoperable with data formats used by major credit bureaus. The HR-XML Consortium’s Sreening workgroup tried to ensure that all data fields relevant to employment screening could be mapped from credit-bureau formats to the HR-XML Consortium’s interchange format. The schema is designed so that where necessary, credit bureau’s codes, scoring, and scoring model identifiers can be passed through within an HR-XML Credit Report instance document. Consequently, a full understanding of how to implement the HR-XML Credit Report schema may require some understanding of the source credit-bureau formats and codes. Implementers should contact the credit bureaus directly for technical details on their data formats and code sets.

|
Component Name [Global types listed at the end of the table.] |
ContentModel* |
Definition |
|
/ |
- CreditReportType - (1/1) |
Contains a report on the credit status/history of the search subject. A credit report is the result of a credit screening request. |

|
/
CreditReport/ |
- FlexibleDatesType - S (0/1) |
The date the report was processed or generated. This uses FlexibleDatesType, which can accommodate date information in a variety of formats, including a string. For example “Spring 2003.” This flexibility is necessary since source data often does not conform to a formal or complete date format. This type is used throughout the schema. |

|
/
CreditReport/ |
- CreditSSNVerifiedType - S (0/*) |
Personal and identifying data used as input to the credit search. |
|
/
CreditReport/ CreditFile/ |
- FlexibleDatesType - S (0/1) |
Date that credit file was established. |
|
/
CreditReport/ CreditFile/ |
- FlexibleDatesType - S (0/1) |
Date of last activity reported. |
|
/
CreditReport/ CreditFile/ |
- EntityIdType - S (0/1) |
File reference number as assigned by Credit Bureau. |

|
CreditFile/ |
- CreditPersonalDataType - S
(1/*) |
A collection of information containing descriptive elements, demographic and contact information about the search subject. |
|
/
[CreditPersonalDataType] / |
xsd:restriction base: xsd:string [Enumerations]: Alias, Other, Current, Prior, NotSpecified |
Further
defines the associated element in the context provided. |
|
/
[CreditPersonalDataType] / |
- xsd:string - |
May
contain a reference number of the company, and name if the member company
that provided the Personal data to the repository. |
|
/
[CreditPersonalDataType] / |
- xsd:string - |
The
actual source that is reporting the ID. |
|
/
[CreditPersonalDataType] / |
- xsd:boolean - |
Information
captured by the credit repository. |
|
/
[CreditPersonalDataType] / |
- xsd:positiveInteger - |
Used
within the FlexibleDetailType to identify the sequence of items. |
|
/
CreditFile/ PersonalData/ |
- EffectiveDateType - S (0/1) |
Date or
time interval on or during which information or events are effective. |
|
/
CreditFile/ PersonalData/ |
xsd:extension base: PersonNameType |
The name of a person. |
|
/
CreditFile/ PersonalData/ PersonName/ |
- PersonNameTypeType - |
Further
defines the associated element in the context provided. |
|
/
CreditFile/ PersonalData/ |
- CreditPostalAddressType - S (0/*) |
A
mailing address. Describes a postal address used for delivery of mail. The
address may include the country code, postal code, a region, municipality,
delivery address, and the recipient. |
|
/
CreditFile/ PersonalData/ PostalAddress/ |
- ReportedDateType - S (0/1) |
The date
the information was recorded or reported. |
|
/
CreditFile/ PersonalData/ PostalAddress/ |
- xsd:string - S (0/1) |
Entity last reporting the information. |
|
/
CreditFile/ PersonalData/ |
- ContactMethodType - S (0/*) |
Defines
the methods of contacting a person or organizations. |
|
/
CreditFile/ PersonalData/ |
- DemographicDetailType - S (0/1) |
A collection of government related and demographic information about the person. |
|
/
CreditFile/ PersonalData/ |
- ReportedDateType - S (0/1) |
The date
the information was recorded or reported. |
|
/
CreditFile/ PersonalData/ |
- xsd:string - S (0/1) |
Entity last reporting the information. |

|
/
CreditReport/ CreditFile/ PersonalData/ |
- DemographicDetailType - S
(0/1) |
Demographic information for the subject upon which the screening will be performed upon. Primarily the GovernmentId, DateofBirth, Race and GenderCode unless otherwise specified by the organization performing the screening. Note that DemographicDetailType is defined within DemographicDetail.xsd, a CPO schema included within ScreeningTypes.xsd. |

|
/
CreditReport/ CreditFile/ |
OrganizationName
- xsd:string - S
(1/1) |
A collection of information about a current or former employer of the person who is the subject of the credit report. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
xsd:restriction base: xsd:string [Enumerations]: Current, Prior, Spouse, Other, Unknown |
Indicates the type employment information being reported. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
- xsd:string - S (1/1) |
The name by which an organization or enterprise is known as established under the laws of a country, state, province or ruling governmental body for the purpose of conducting business transactions. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
- xsd:string - S (0/1) |
The title of the position held by the human resource. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
- CreditPostalAddressType - S (0/1) |
CPO's PostalAddress 1.2 version. Defines the mailing address of the worksite. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ PostalAddress/ |
- ReportedDateType - S (0/1) |
The date the information was added to the credit file. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
xsd:extension base: TelcomNumberType |
A telephone number. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ Telephone/ |
- xsd:string - |
The type or classification for the related component. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
- ReportedDateType - S (0/1) |
The date the information was added to the credit file. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
- FlexibleDatesType - S (0/1) |
The date on which the reported information was last verified |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
- EffectiveDateType - S (0/1) |
Dates of employment. |
|
/
CreditReport/ CreditFile/ EmploymentInformation/ |
- PositionCompensationType - S (0/*) |
Details on the compensation package offered to a human resource. |
|
/ CreditReport/
CreditFile/ EmploymentInformation/ |
xsd:restriction base: xsd:string [Enumerations]: Current, Prior, Spouse, Other, Unknown |
The type or classification for the related component. |

|
/
CreditReport/ CreditFile/ |
- CreditPersonalDataType – S (0/*) |
Any other names or aliases reported for the search subject. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ |
- EffectiveDateType - S (0/1) |
Date or time interval on or during which information is effective or known to be correct. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ |
xsd:extension base: PersonNameType |
The name of a person. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ PersonName/ |
- PersonNameTypeType - |
The type of PersonName. Enumerated values include Subject, Alias, Other, Contact. Other values are permitted if pre-fixed with “x:”. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ |
- CreditPostalAddressType - S (0/*) |
CPO's PostalAddress 1.2 version. Defines the mailing address of the worksite. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ PostalAddress/ |
- ReportedDateType - S (0/1) |
The date the information was added to the credit file. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ |
- ContactMethodType - S (0/*) |
Contact information, such as work or home telephone number. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ |
- DemographicDetailType - S (0/1) |
A collection of government related and demographic information about the person. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ |
- ReportedDateType - S (0/1) |
The date
the information was recorded or reported. |
|
/
CreditReport/ CreditFile/ ReportedAliases/ |
- xsd:string - S (0/1) |
Entity last reporting the information. |

The credit repository bureaus can identify the type of business of the liability holder. This information is needed for an automated scoring application. This data is available for liability and inquiry records from Equifax, Experian and Trans Union.
|
/
CreditReport/ |
- CreditConsumerReferralType - S (0/*) |
Contains contact information for the credit bureau(s) and/or other organization responsible for reporting the information in the credit report. |
|
/
CreditReport/ CreditConsumerReferal/ |
- CreditBusinessTypeType - S (0/1) |
The credit repository bureaus can identify the type of business of the liability holder. This information is needed for an automated scoring application. This data is available for liability and inquiry records from Equifax, Experian and Trans Union. |
|
/
CreditReport/ CreditConsumerReferal/ CreditBusinessType/ |
- CreditBusinessTypeQualifiers - S (0/1) |
Container for the value required by the current context. |
|
/
CreditReport/ CreditConsumerReferal/ CreditBusinessType/ |
- xsd:string - S (0/1) |
A code provided by the credit bureau repository. |
|
/
CreditReport/ CreditConsumerReferal/ CreditBusinessType/ |
- xsd:string - S (0/1) |
RepositoryCode and RepositoryValue have a "name-value pair" relationship. RepositoryCode is a code assigned by the repository. RepositoryValue is the corresponding descriptive field for RepositoryCode. |

|
- CreditLiabilityType - S (0/*) |
A collection of information regarding a credit liability -- e.g., loan, revolving credit line, etc. -- associated with the search subject. |
|
|
/
CreditReport/ CreditLiability/ |
- xsd:boolean - S (0/1) |
A boolean indicating whether further review may be required. |
|
/
CreditReport/ CreditLiability/ |
- FlexibleDatesType - S (0/1) |
The date that the credit liability account was closed by the liability holder. |
|
/
CreditReport/ CreditLiability/ |
- xsd:string - S (0/1) |
The account number assigned to the liability account as provided by the credit repository bureau. |
|
/
CreditReport/ CreditLiability/ |
- FlexibleDatesType - S (0/1) |
The date that the credit liability account was opened by the liability holder. |
|
/
CreditReport/ CreditLiability/ |
- FlexibleDatesType - S (0/1) |
The date that the credit liability was reported paid to zero by the liability holder. |
|
/
CreditReport/ CreditLiability/ |
- FlexibleDatesType - S (0/1) |
The date that the credit liability data was reported by the liability holder. |
|
/
CreditReport/ CreditLiability/ |
- FlexibleDatesType - S (0/1) |
The AccountStatusDate is the date that the account's CurrentRating was last changed by the liability holder. If the CurrentRating status is Bankruptcy, for example, the StatusDate would be when the account first went into bankkruptcy. |
|
/
CreditReport/ CreditLiability/ |
- CurrencyAmountType - S (0/1) |
The amount charged off by a liability holder, usually for an account in collection. |
|
/
CreditReport/ CreditLiability/ |
- xsd:string - S (0/1) |
A description of any property or other collateral securing the loan. |
|
/
CreditReport/ CreditLiability/ |
- xsd:boolean - S (0/1) |
A boolean to indicate whether or not the consumer (borrower) disputes information reported for this account and has filed a FCRA dispute form. |
|
/
CreditReport/ CreditLiability/ |
- xsd:boolean - S (0/1) |
A boolean that indicates whether or not the liability account contains adverse or derogatory information. |
|
/
CreditReport/ CreditLiability/ |
xsd:extension base: xsd:string |
Terms of the deferred acount. |
|
/
CreditReport/ CreditLiability/ DeferredAccountTerms/ |
- DeferredLoanTermsType - |
Type of loan terms. Allows Experian value – “D” – or additional values if pre-fixed with “x:”. |
|
/
CreditReport/ CreditLiability/ |
- CurrencyAmountType - S (0/1) |
The highest balance recorded for the account by the liability holder. |
|
/
CreditReport/ CreditLiability/ |
- CurrencyAmountType - S (0/1) |
The highest credit limit established for the account by the liability holder. It could be higher than the current credit limit. |
|
/
CreditReport/ CreditLiability/ |
- FlexibleDatesType - S (0/1) |
Date of last activity reported. |
|
/
CreditReport/ CreditLiability/ |
- xsd:string - S (0/1) |
The current manner of payment for the liability account. |
|
/
CreditReport/ CreditLiability/ |
- LateDelinquentCountType - S (0/*) |
The number of times the liability account was reported late by the liability holder. |
|
/
CreditReport/ CreditLiability/ |
- CurrencyAmountType - S (0/1) |
The original amount of the loan. |
|
/
CreditReport/ CreditLiability/ |
- CurrencyAmountType - S (0/1) |
The monthly amount the consumer has paid or is scheduled to pay. |
|
/
CreditReport/ CreditLiability/ |
- CurrencyAmountType - S (0/1) |
The estimated monthly amount the consumer will pay or is scheduled to pay. |
|
/
CreditReport/ CreditLiability/ |
- CurrencyAmountType - S (0/1) |
The monthly amount the consumer is scheduled to pay. |
|
/
CreditReport/ CreditLiability/ |