TIN ComplianceA resource from TIN Comply
IRIS form rules

IRIS Form 1098-E: rules and XML elements

Form 1098-E, Student Loan Interest Statement, has no business rules of its own in the IRS rule sets for tax years 2022 to 2026; IRIS checks it against the schema and the rules every form in its group shares. Here are the 10 elements of Form1098EDetail in the tax year 2026 XML record.

Submission group 1XML element Form1098EDetailElements 10, 7 required

The form, box by box: where each box goes in IRIS

Copy A of Form 1098-E, with the IRIS XML element written at every box and a number that matches the table below. The table adds whether the element is required, its format, the Pub 1220 (FIRE) position the box used to have, and the portal CSV template column it lands in.

IRS Form 1098-E with the IRIS XML element shown at each box, numbered to match the field mapBox 1: VOIDIRIS elementVoidIndRequiredRequired, 1 or 0Pub 1220 (FIRE)None: FIRE has no void recordCSV templateNo column in the TY2025 templateClick to open row 1 in the field mapBox 2: CORRECTEDIRIS elementCorrectedInd, with PrevSubmittedRecRecipientGrp when 1RequiredRequired, 1 or 0Pub 1220 (FIRE)B record 6CSV templateNo column in the TY2025 templateClick to open row 2 in the field mapBox 3: RECIPIENT'S/LENDER'S nameIRIS elementIRSubmission1Header/IssuerDetail/BusinessName/BusinessNameLine1Txt (BusinessNameLine2Txt optional), or PersonName (PersonFirstNm, PersonMiddleNm, PersonLastNm, SuffixNm); name control optionalRequiredRequired in the headerPub 1220 (FIRE)A record 53-92 (second name line 93-132); name control 21-24CSV templateLender Name Type
Lender Business or Entity Name Line 1
Lender Business or Entity Name Line 2
Lender First Name
Lender Middle Name
Lender Last Name (Surname)
Lender Suffix
Click to open row 3 in the field map
Box 4: Calendar year (printed)IRIS elementTaxYr (also IRSubmission1Header/TaxYr and the manifest)RequiredRequired, four-digit yearPub 1220 (FIRE)B record 2-5CSV templateTax YearClick to open row 4 in the field mapBox 5: Street addressIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/AddressLine1TxtRequiredRequiredPub 1220 (FIRE)A record 134-173CSV templateLender Address Line 1Click to open row 5 in the field mapBox 6: Room/suite no.IRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/AddressLine2TxtRequiredOptionalPub 1220 (FIRE)Within A record 134-173 (FIRE has one address line)CSV templateLender Address Line 2Click to open row 6 in the field mapBox 7: City/townIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/CityNmRequiredRequiredPub 1220 (FIRE)A record 174-213CSV templateLender City/TownClick to open row 7 in the field mapBox 8: State/provinceIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/StateAbbreviationCd (ForeignAddress/ProvinceOrStateNm)RequiredRequired for a U.S. addressPub 1220 (FIRE)A record 214-215CSV templateLender State/Province/TerritoryClick to open row 8 in the field mapBox 9: CountryIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/ForeignAddress/CountryCdRequiredForeign address onlyPub 1220 (FIRE)A record 52 (foreign entity indicator); the address stays in 134-224CSV templateLender CountryClick to open row 9 in the field mapBox 10: ZIP/foreign codeIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/ZIPCd (ForeignAddress/ForeignPostalCd)RequiredRequired for a U.S. address, 5 or 9 digitsPub 1220 (FIRE)A record 216-224CSV templateLender ZIP/Postal CodeClick to open row 10 in the field mapBox 11: Telephone number:IRIS elementIRSubmission1Header/IssuerDetail/PhoneNumRequiredOptionalPub 1220 (FIRE)A record 225-239CSV templateLender Phone Type
Lender Phone
Click to open row 11 in the field map
Box 12: 1 Student loan interest received by lenderIRIS elementStudentLoanIntRcvdByLenderAmtRequiredRequired, amount, 2 decimalsPub 1220 (FIRE)Amount code 1, B record 55-66CSV templateBox 1 - InterestClick to open row 12 in the field mapBox 13: RECIPIENT'S TINIRIS elementIRSubmission1Header/IssuerDetail/TIN with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN)RequiredRequired, 9 digitsPub 1220 (FIRE)A record 12-20CSV templateLender TIN Type
Lender Taxpayer ID Number
Click to open row 13 in the field map
Box 14: BORROWER'S TINIRIS elementRecipientDetail/TIN with RecipientDetail/TINSubmittedTypeCdRequiredRequired, 9 digits, no dashesPub 1220 (FIRE)B record 12-20; TIN type 11CSV templateBorrower TIN Type
Borrower Taxpayer ID Number
Click to open row 14 in the field map
Box 15: BORROWER'S nameIRIS elementRecipientDetail/PersonName (PersonFirstNm, PersonMiddleNm, PersonLastNm, SuffixNm) or RecipientDetail/BusinessName/BusinessNameLine1Txt and BusinessNameLine2Txt; name control optional; AdditionalRecipientTxt for a second payeeRequiredRequired (one of the two)Pub 1220 (FIRE)B record 288-367; name control 7-10CSV templateBorrower First Name
Borrower Middle Name
Borrower Last Name (Surname)
Borrower Suffix
Click to open row 15 in the field map
Box 16: Street addressIRIS elementRecipientDetail/MailingAddressGrp/USAddress/AddressLine1TxtRequiredRequiredPub 1220 (FIRE)B record 368-407CSV templateBorrower Address Line 1Click to open row 16 in the field mapBox 17: Apt. no.IRIS elementRecipientDetail/MailingAddressGrp/USAddress/AddressLine2TxtRequiredOptionalPub 1220 (FIRE)Within B record 368-407 (FIRE has one address line)CSV templateBorrower Address Line 2Click to open row 17 in the field mapBox 18: City/townIRIS elementRecipientDetail/MailingAddressGrp/USAddress/CityNmRequiredRequiredPub 1220 (FIRE)B record 448-487CSV templateBorrower City/TownClick to open row 18 in the field mapBox 19: State/provinceIRIS elementRecipientDetail/MailingAddressGrp/USAddress/StateAbbreviationCd (ForeignAddress/ProvinceOrStateNm)RequiredRequired for a U.S. addressPub 1220 (FIRE)B record 488-489CSV templateBorrower State/Province/TerritoryClick to open row 19 in the field mapBox 20: CountryIRIS elementRecipientDetail/MailingAddressGrp/ForeignAddress/CountryCdRequiredForeign address onlyPub 1220 (FIRE)B record 287 (foreign country indicator); the address stays in 368-498CSV templateBorrower CountryClick to open row 20 in the field mapBox 21: ZIP/foreign codeIRIS elementRecipientDetail/MailingAddressGrp/USAddress/ZIPCd (ForeignAddress/ForeignPostalCd)RequiredRequired for a U.S. address, 5 or 9 digitsPub 1220 (FIRE)B record 490-498CSV templateBorrower ZIP/Postal CodeClick to open row 21 in the field mapBox 22: Account number (see instructions)IRIS elementRecipientAccountNumRequiredOptional, up to 30 charactersPub 1220 (FIRE)B record 21-40CSV templateForm Account NumberClick to open row 22 in the field mapBox 23: 2 Check if box 1 does not include loan origination feesIRIS elementNotLoanOrigFeeOrCapInterestIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 547CSV templateBox 2 - Origination FeesClick to open row 23 in the field map
Form 1098-E, Copy A, from IRS.gov, with the IRIS element for each box. Hover a box for its element, required flag and columns; click it to jump to its row in the field map, and click the row number to come back. The numbers match the field map below. Full-size image.

Field map: box by box

Element paths are relative to Form1098EDetail unless they start with IRSubmission. The grey part of a path is the group; the dark part is the element itself.

#Box on the formIRIS elementRequired, formatPub 1220 (FIRE)CSV column (TY2025)
1VOIDVoidIndRequired1 or 0None: FIRE has no void recordNot in the template
2CORRECTEDCorrectedInd, with PrevSubmittedRecRecipientGrp when 1Required1 or 0B record 6Not in the template
3RECIPIENT'S/LENDER'S nameIRSubmission1Header/IssuerDetail/BusinessName/BusinessNameLine1TxtorPersonNameName control optionalRequiredin the headerA record 53-92 (second name line 93-132); name control 21-24Lender Name TypeLender Business or Entity Name Line 1Lender Business or Entity Name Line 2
and 4 more columnsLender First NameLender Middle NameLender Last Name (Surname)Lender Suffix
4Calendar year (printed)TaxYrAlso in IRSubmission1Header/TaxYr and the manifestRequiredFour-digit yearB record 2-5Tax Year
5Street addressIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/AddressLine1TxtRequiredA record 134-173Lender Address Line 1
6Room/suite no.IRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/AddressLine2TxtOptionalWithin A record 134-173 (FIRE has one address line)Lender Address Line 2
7City/townIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/CityNmRequiredA record 174-213Lender City/Town
8State/provinceIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/StateAbbreviationCd (ForeignAddress/ProvinceOrStateNm)Requiredfor a U.S. addressA record 214-215Lender State/Province/Territory
9CountryIRSubmission1Header/IssuerDetail/MailingAddressGrp/ForeignAddress/CountryCdForeign address onlyA record 52 (foreign entity indicator); the address stays in 134-224Lender Country
10ZIP/foreign codeIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/ZIPCd (ForeignAddress/ForeignPostalCd)Requiredfor a U.S. address5 or 9 digitsA record 216-224Lender ZIP/Postal Code
11Telephone number:IRSubmission1Header/IssuerDetail/PhoneNumOptionalA record 225-239Lender Phone TypeLender Phone
121 Student loan interest received by lenderStudentLoanIntRcvdByLenderAmtRequiredAmount, 2 decimalsAmount code 1, B record 55-66Box 1 - Interest
13RECIPIENT'S TINIRSubmission1Header/IssuerDetail/TIN with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN)Required9 digitsA record 12-20Lender TIN TypeLender Taxpayer ID Number
14BORROWER'S TINRecipientDetail/TIN with RecipientDetail/TINSubmittedTypeCdRequired9 digits, no dashesB record 12-20; TIN type 11Borrower TIN TypeBorrower Taxpayer ID Number
15BORROWER'S nameRecipientDetail/PersonNameorRecipientDetail/BusinessName/BusinessNameLine1TxtName control optionalRequired(one of the two)B record 288-367; name control 7-10Borrower First NameBorrower Middle NameBorrower Last Name (Surname)Borrower Suffix
16Street addressRecipientDetail/MailingAddressGrp/USAddress/AddressLine1TxtRequiredB record 368-407Borrower Address Line 1
17Apt. no.RecipientDetail/MailingAddressGrp/USAddress/AddressLine2TxtOptionalWithin B record 368-407 (FIRE has one address line)Borrower Address Line 2
18City/townRecipientDetail/MailingAddressGrp/USAddress/CityNmRequiredB record 448-487Borrower City/Town
19State/provinceRecipientDetail/MailingAddressGrp/USAddress/StateAbbreviationCd (ForeignAddress/ProvinceOrStateNm)Requiredfor a U.S. addressB record 488-489Borrower State/Province/Territory
20CountryRecipientDetail/MailingAddressGrp/ForeignAddress/CountryCdForeign address onlyB record 287 (foreign country indicator); the address stays in 368-498Borrower Country
21ZIP/foreign codeRecipientDetail/MailingAddressGrp/USAddress/ZIPCd (ForeignAddress/ForeignPostalCd)Requiredfor a U.S. address5 or 9 digitsB record 490-498Borrower ZIP/Postal Code
22Account number (see instructions)RecipientAccountNumOptionalUp to 30 charactersB record 21-40Form Account Number
232 Check if box 1 does not include loan origination feesNotLoanOrigFeeOrCapInterestIndRequired1 or 0B record 547Box 2 - Origination Fees

Elements with no box on the form

IRIS elementRequired, formatPub 1220 (FIRE)
 RecordIdRequiredWhole number up to 8 digitsB record 500-507 (sequence number; not the same thing)
 IssuerOfficeCdOptionalExactly 4 charactersB record 41-44

Notes

  • Path: IRTransmission, IRSubmission1Grp, IRSubmission1Detail, Form1098EDetail (one per return). The filer (payer, lender, trustee or issuer) appears once, in the submission header, not in each return.

Form 1098-E business rules

The IRS rule sets for tax years 2022 to 2026 contain no rule numbered for Form 1098-E. Its returns are still checked against the schema and against the rules every form shares, such as SHAREDIRFORM014 (payee name and TIN), listed on the rules every form shares page.

Every element of Form1098EDetail, in schema order

IRTransmission › IRSubmission1Grp › IRSubmission1Detail › Form1098EDetail

Each Form 1098-E return is one Form1098EDetail record in a submission of group 1. The table lists all 10 elements in schema order for tax year 2026, including the ones with no box on the form: whether each is required, and the format IRIS accepts. Element names are the ones the IRS uses in its IRIS ATS examples and Publication 5718; the IRS revises the schema each year. A FIRE filer converting a Pub 1220 file finds the field-by-field mapping in the Pub 1220 to IRIS crosswalk.

ElementRequiredFormat
TaxYrRequiredFour-digit year
RecordIdRequiredWhole number, up to 8 digits
IssuerOfficeCdOptionalExactly 4 characters
VoidIndRequired1 (yes) or 0 (no)
CorrectedIndRequired1 (yes) or 0 (no)
PrevSubmittedRecRecipientGrpOptionalGroup of elements
OtherIntakeSystemIndRequired in the group1 (yes) or 0 (no) (1 when the original was filed outside IRIS)
OtherIntakeSystemNmOptionalGroup of elements (FIRE, for example)
UniqueRecordIdOptional (the IRIS original's record ID)
TINOptional9 digits, no dashes (original payee TIN)
PersonNameRequired in the groupGroup of elements (original payee name (or BusinessName))
BusinessNameRequired in the groupGroup of elements
RecipientDetailRequiredGroup of elements
RecipientAccountNumOptionalText, up to 30 characters
StudentLoanIntRcvdByLenderAmtRequiredAmount, zero or more, up to 2 decimal places
NotLoanOrigFeeOrCapInterestIndRequired1 (yes) or 0 (no)

CSV template columns: the IRIS Taxpayer Portal upload

The portal takes Form 1098-E as a CSV upload built on the IRS template for the form. The tax year 2025 template has 35 columns (16 required); the IRS has not published tax year 2026 templates, and a template is tied to its tax year. The column letter is the spreadsheet column and the format is from the IRS Template Formatting Guidelines; the IRIS element behind each box is in the field map above. Download a sample 1098-E CSV with two fictitious records in this layout, for seeing the shape of the file, not for uploading; check a real file with the IRIS CSV upload checker.

Col.Template columnRequiredFormat
AForm TypeOptionalform type, filled in by the template
BTax YearOptionaltax year
CLender TIN TypeRequiredTIN type: EIN, SSN
DLender Taxpayer ID NumberRequiredTIN with dashes (XX-XXXXXXX or XXX-XX-XXXX)
ELender Name TypeRequiredB (business) or I (individual): B, I
FLender Business or Entity Name Line 1Optionaltext; up to 40 characters
GLender Business or Entity Name Line 2Optionaltext; up to 40 characters
HLender First NameOptionaltext; up to 20 characters
ILender Middle NameOptionaltext; up to 20 characters
JLender Last Name (Surname)Optionaltext; up to 20 characters
KLender SuffixOptionaltext; up to 20 characters
LLender CountryRequiredcountry code (US for United States)
MLender Address Line 1Requiredtext; up to 35 characters
NLender Address Line 2Optionaltext; up to 35 characters
OLender City/TownRequiredtext; up to 40 characters
PLender State/Province/TerritoryRequiredtwo-letter state (or province, up to 17 characters); up to 17 characters
QLender ZIP/Postal CodeRequiredZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters
RLender Phone TypeOptionalD (domestic) or I (international): D, I
SLender PhoneOptionalphone, 10 digits
TBorrower TIN TypeOptionalTIN type: ATIN, ITIN, SSN, UND
UBorrower Taxpayer ID NumberOptionalTIN with dashes (XX-XXXXXXX or XXX-XX-XXXX)
VBorrower First NameRequiredtext; up to 20 characters
WBorrower Middle NameOptionaltext; up to 20 characters
XBorrower Last Name (Surname)Requiredtext; up to 20 characters
YBorrower SuffixOptionaltext; up to 20 characters
ZBorrower CountryRequiredcountry code (US for United States)
AABorrower Address Line 1Requiredtext; up to 35 characters
ABBorrower Address Line 2Optionaltext; up to 35 characters
ACBorrower City/TownRequiredtext; up to 40 characters
ADBorrower State/Province/TerritoryRequiredtwo-letter state (or province, up to 17 characters); up to 17 characters
AEBorrower ZIP/Postal CodeRequiredZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters
AFOffice CodeOptional4 characters
AGForm Account NumberOptionaltext; up to 20 characters
AHBox 1 - InterestRequiredamount, no $ or commas
AIBox 2 - Origination FeesOptionalY or N

Check a file before you send it. TIN Comply's free IRIS 1099 File Checker runs an IRIS XML or CSV file against the IRS business rules in your browser.