New:Thread Pilot—AI follow-ups for Gmail.
Learn more
Back to Metro 2 Documentation

Metro 2 Header Record

The Header Record is the first record in every Metro 2 file, containing essential file-level information and data furnisher identification.

Overview

The Header Record is a mandatory component that appears once at the beginning of every Metro 2 credit reporting file. It identifies the data furnisher submitting the file and provides critical metadata about the file contents. The Header Record must be exactly 426 characters in length and follows a fixed-width format.

This record establishes the context for all subsequent Base Segments and optional segments in the file, ensuring proper routing and processing by credit bureaus. Without a valid Header Record, the entire file will be rejected by the receiving credit bureau.

Header Record Structure

FieldPositionLengthTypeDescription
Record Descriptor Word1-44AlphaMust be "HEADER" (left-justified)
Record Identifier5-84NumericCycle number (right-justified, zero-filled)
Processing Date9-168Date (MMDDYYYY)Date file was created
Program Identifier17-215AlphaSoftware identifier (left-justified)
Program Version22-265AlphanumericSoftware version number
Reporter Name27-6640AlphanumericData furnisher's name
Reporter Address67-16296AlphanumericComplete furnisher address
Reporter Telephone163-17210Numeric10-digit phone number
Software Vendor Name173-21240AlphanumericName of software vendor
Software Vendor Contact213-25240AlphanumericVendor contact person
Software Vendor Phone253-26210NumericVendor phone number

Note: This table shows primary fields. The complete Header Record contains additional fields for a total length of 426 characters.

Key Components

Record Descriptor Word

The first four positions must contain "HEADER" (left-justified with trailing spaces). This identifier tells the credit bureau that this is the file header and not a Base Segment or other record type.

Processing Date

The date the file was created in MMDDYYYY format. This is critical for file tracking and ensuring data is processed in the correct sequence. The processing date helps credit bureaus identify duplicate submissions and maintain proper chronological order.

Reporter Identification

The reporter name, address, and telephone number identify the data furnisher submitting the file. This information must match the furnisher's registration with the credit bureau and is used for communication regarding file issues or questions.

Software Information

The program identifier, version, software vendor name, contact, and phone number provide traceability for the software that generated the Metro 2 file. This information is valuable for troubleshooting formatting issues and ensuring compliance with Metro 2 specifications.

Example Header Record

HEADER0001112020251234VEND1.0  ABC Financial Services Inc.        123 Main Street, Suite 500, New York, NY 10001
                                                              2125551234Switch Labs                            John Smith                              8005551234

Note: This is a simplified example showing key fields. Actual Header Records include additional fields and must be exactly 426 characters.

Important Notes

  • The Header Record must always be exactly 426 characters in length
  • Only one Header Record is permitted per Metro 2 file
  • The Header Record must be the first record in the file, before any Base Segments
  • Alphanumeric fields should be left-justified and space-filled
  • Numeric fields must be right-justified and zero-filled
  • All dates must be in MMDDYYYY format with valid month, day, and year values
  • Phone numbers must be 10 digits without formatting characters (no dashes, spaces, or parentheses)

Best Practices

1

Maintain Consistent Information

Ensure that your reporter information (name, address, phone) remains consistent across all file submissions and matches your registration with the credit bureau.

2

Validate Before Submission

Always validate your Header Record before submitting files to credit bureaus. A single character error can cause the entire file to be rejected.

3

Keep Software Information Current

Update the program identifier and version fields whenever you upgrade your reporting software. This helps with troubleshooting and tracking file generation.

4

Use Accurate Processing Dates

Set the processing date to the actual date the file was created. Incorrect dates can cause processing delays or file rejections.

5

Document Your Header Configuration

Maintain documentation of your Header Record configuration for reference and to ensure consistency across team members and systems.

Common Errors to Avoid

  • Incorrect record length (not exactly 426 characters)
  • Using "HEAD" instead of "HEADER" in the descriptor word
  • Invalid date formats (e.g., YYYYMMDD instead of MMDDYYYY)
  • Including formatting in phone numbers (dashes, spaces, parentheses)
  • Leaving required fields blank or filled with only spaces
  • Using special characters in fields designated for alphanumeric data

Ready to Start Reporting?

Our platform makes Metro 2 Header Record creation simple and error-free

Contact

Tell us what you're building and we'll get in touch fast

Ship a proof-of-concept, integrate Metro2, or hand off the workflow entirely—we respond within one business day and loop in the right Switch Labs partner for your stack.

Response Time
< 24 hours
Delivery Options
Product | Services

By submitting you agree to let Switch Labs contact you about relevant products and services.