The form, box by box: where each box goes in IRIS
Copy A of Form 1099-C, 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.
Box 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: CREDITOR'S name, street address, city or town, state or province, country,IRIS elementIRSubmission1Header/ IssuerDetail: BusinessName/ BusinessNameLine1Txt or PersonName, MailingAddressGrp (USAddress or ForeignAddress), PhoneNumRequiredRequired in the headerPub 1220 (FIRE)A record 12-20 (TIN), 53-132 (name), 134-224 (address), 225-239 (phone)CSV templateCreditor TIN TypeCreditor Taxpayer ID Number
Creditor Name Type
Creditor Business or Entity Name Line 1
Creditor Business or Entity Name Line 2
Creditor First Name
Creditor Middle Name
Creditor Last Name (Surname)
Creditor Suffix
Creditor Country
Creditor Address Line 1
Creditor Address Line 2
Creditor City/Town
Creditor State/Province/Territory
Creditor ZIP/Postal Code
Creditor Phone Type
Creditor PhoneClick to open row 3 in the field mapBox 4: 1 Date of identifiable eventIRIS element
IdentifiableEventDtRequiredOptional, date YYYY-MM-DDPub 1220 (FIRE)B record 548-555CSV templateBox 1 - Date of identifiable eventClick to open row 4 in the field mapBox 5: 2 Amount of debt dischargedIRIS elementDebtDischargeAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 2, B record 67-78CSV templateBox 2 - Amount of debt dischargedClick to open row 5 in the field mapBox 6: 3 Interest, if included in box 2IRIS elementInterestAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 3, B record 79-90CSV templateBox 3 - Interest if included in Box 2Click to open row 6 in the field mapBox 7: For calendar yearIRIS elementTaxYr (also IRSubmission1Header/ TaxYr and the manifest)RequiredRequired, four-digit yearPub 1220 (FIRE)B record 2-5CSV templateTax YearClick to open row 7 in the field mapBox 8: CREDITOR'S TINIRIS elementIRSubmission1Header/IssuerDetail/ TIN with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN)RequiredRequired, 9 digitsPub 1220 (FIRE)A record 12-20CSV templateCreditor TIN TypeCreditor Taxpayer ID NumberClick to open row 8 in the field mapBox 9: DEBTOR'S TINIRIS element
RecipientDetail/ TIN with RecipientDetail/ TINSubmittedTypeCdRequiredRequired, 9 digits, no dashesPub 1220 (FIRE)B record 12-20; TIN type 11CSV templateDebtor TIN TypeDebtor Taxpayer ID NumberClick to open row 9 in the field mapBox 10: 4 Debt descriptionIRIS element
DebtDescRequiredOptional, text up to 100 charactersPub 1220 (FIRE)B record 556-594CSV templateBox 4 - Debt descriptionClick to open row 10 in the field mapBox 11: DEBTOR'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 templateDebtor Name TypeDebtor Business or Entity Name Line 1
Debtor Business or Entity Name Line 2
Debtor First Name
Debtor Middle Name
Debtor Last Name (Surname)
Debtor SuffixClick to open row 11 in the field mapBox 12: Street address (including apt. no.)IRIS element
RecipientDetail/MailingAddressGrp/USAddress/ AddressLine1TxtRequiredRequiredPub 1220 (FIRE)B record 368-407CSV templateDebtor Address Line 1Click to open row 12 in the field mapBox 13: 5 Check here if the debtor was personally liable forIRIS elementDebtorLiableDebtRepaymentIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 595CSV templateBox 5 - If checked, the debtor was personally liable for repayment of the debtClick to open row 13 in the field mapBox 14: City or town, state or province, country, and ZIP or foreign postal codeIRIS elementRecipientDetail/MailingAddressGrp/ USAddress: CityNm, StateAbbreviationCd, ZIPCd (ForeignAddress: CityNm, ProvinceOrStateNm, CountryCd, ForeignPostalCd)RequiredRequiredPub 1220 (FIRE)B record 448-487, 488-489, 490-498CSV templateDebtor CountryDebtor City/Town
Debtor State/Province/Territory
Debtor ZIP/Postal CodeClick to open row 14 in the field mapBox 15: Account number (see instructions)IRIS element
RecipientAccountNumRequiredOptional, up to 30 charactersPub 1220 (FIRE)B record 21-40CSV templateForm Account NumberClick to open row 15 in the field mapBox 16: 6 Identifiable event codeIRIS elementIdentifiableEventCdRequiredRequired, code from a list of 8Pub 1220 (FIRE)B record 547CSV templateBox 6 - Identifable event codeClick to open row 16 in the field mapBox 17: 7 Fair market value of propertyIRIS elementFairMarketValueAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 7, B record 127-138CSV templateBox 7 - Fair market value of propertyClick to open row 17 in the field mapField map: box by box
| # | Box on the form | IRIS element (relative to Form1099CDetail unless it starts with IRSubmission) | Required, format | Pub 1220 (FIRE) position | CSV template column (TY2025 portal upload) |
|---|---|---|---|---|---|
| 1 | VOID | VoidInd | Required, 1 or 0 | None: FIRE has no void record | Not in the template |
| 2 | CORRECTED | CorrectedInd, with PrevSubmittedRecRecipientGrp when 1 | Required, 1 or 0 | B record 6 | Not in the template |
| 3 | CREDITOR'S name, street address, city or town, state or province, country, | IRSubmission1Header/: BusinessName/ or PersonName, MailingAddressGrp, PhoneNum | Required in the header | A record 12-20 (TIN), 53-132 (name), 134-224 (address), 225-239 (phone) | Creditor TIN Type Creditor Taxpayer ID Number Creditor Name Type Creditor Business or Entity Name Line 1 Creditor Business or Entity Name Line 2 Creditor First Name Creditor Middle Name Creditor Last Name (Surname) Creditor Suffix Creditor Country Creditor Address Line 1 Creditor Address Line 2 Creditor City/Town Creditor State/Province/Territory Creditor ZIP/Postal Code Creditor Phone Type Creditor Phone |
| 4 | 1 Date of identifiable event | IdentifiableEventDt | Optional, date YYYY-MM-DD | B record 548-555 | Box 1 - Date of identifiable event |
| 5 | 2 Amount of debt discharged | DebtDischargeAmt | Optional, amount, 2 decimals | Amount code 2, B record 67-78 | Box 2 - Amount of debt discharged |
| 6 | 3 Interest, if included in box 2 | InterestAmt | Optional, amount, 2 decimals | Amount code 3, B record 79-90 | Box 3 - Interest if included in Box 2 |
| 7 | For calendar year | TaxYr (also IRSubmission1Header/ and the manifest) | Required, four-digit year | B record 2-5 | Tax Year |
| 8 | CREDITOR'S TIN | IRSubmission1Header/ with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN) | Required, 9 digits | A record 12-20 | Creditor TIN Type Creditor Taxpayer ID Number |
| 9 | DEBTOR'S TIN | RecipientDetail/ with RecipientDetail/ | Required, 9 digits, no dashes | B record 12-20; TIN type 11 | Debtor TIN Type Debtor Taxpayer ID Number |
| 10 | 4 Debt description | DebtDesc | Optional, text up to 100 characters | B record 556-594 | Box 4 - Debt description |
| 11 | DEBTOR'S name | RecipientDetail/ or RecipientDetail/; name control optional | Required (one of the two) | B record 288-367; name control 7-10 | Debtor Name Type Debtor Business or Entity Name Line 1 Debtor Business or Entity Name Line 2 Debtor First Name Debtor Middle Name Debtor Last Name (Surname) Debtor Suffix |
| 12 | Street address (including apt. no.) | RecipientDetail/ | Required | B record 368-407 | Debtor Address Line 1 |
| 13 | 5 Check here if the debtor was personally liable for | DebtorLiableDebtRepaymentInd | Required, 1 or 0 | B record 595 | Box 5 - If checked, the debtor was personally liable for repayment of the debt |
| 14 | City or town, state or province, country, and ZIP or foreign postal code | RecipientDetail/: CityNm, StateAbbreviationCd, ZIPCd (or ForeignAddress) | Required | B record 448-487, 488-489, 490-498 | Debtor Country Debtor City/Town Debtor State/Province/Territory Debtor ZIP/Postal Code |
| 15 | Account number (see instructions) | RecipientAccountNum | Optional, up to 30 characters | B record 21-40 | Form Account Number |
| 16 | 6 Identifiable event code | IdentifiableEventCd | Required, code from a list of 8 | B record 547 | Box 6 - Identifable event code |
| 17 | 7 Fair market value of property | FairMarketValueAmt | Optional, amount, 2 decimals | Amount code 7, B record 127-138 | Box 7 - Fair market value of property |
Elements with no box on the form
| IRIS element | Required, format | Pub 1220 (FIRE) position | |
|---|---|---|---|
RecordId | Required, whole number up to 8 digits | B record 500-507 (sequence number; not the same thing) | |
IssuerOfficeCd | Optional, exactly 4 characters | B record 41-44 |
Notes
- Path: IRTransmission, IRSubmission1Grp, IRSubmission1Detail, Form1099CDetail (one per return). The filer (payer, lender, trustee or issuer) appears once, in the submission header, not in each return.
Form 1099-C business rules
Besides the rules on this page, IRIS checks the rules every form shares, such as SHAREDIRFORM014 (payee name and TIN); those are on the cross-form error code pages. The IRIS Taxpayer Portal also takes Form 1099-C as a CSV upload, using the IRS template for the form.
In the tax year 2026 rule set: 3 report error and reject over the threshold. A reject stops the submission; a report error is accepted with errors and counts as filed; past an unpublished threshold, report errors reject the submission. The descriptions are our own summaries; your acknowledgment gives the rule number.
| Rule | Severity | What it checks |
|---|---|---|
| F1099C001 | Report error, reject over threshold | The amount of debt discharged is required. |
| F1099C002 | Report error, reject over threshold | Interest included in the discharged debt cannot be more than the debt discharged. |
| F1099C003 | Report error, reject over threshold | A description of the debt is required. |
Every element of Form1099CDetail, in schema order
Each Form 1099-C return is one Form1099CDetail record in a submission of group 1. The table lists all 15 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.
| Element | Required | Format |
|---|---|---|
TaxYr | Required | Four-digit year |
RecordId | Required | Whole number, up to 8 digits |
IssuerOfficeCd | Optional | Exactly 4 characters |
VoidInd | Required | 1 (yes) or 0 (no) |
CorrectedInd | Required | 1 (yes) or 0 (no) |
PrevSubmittedRecRecipientGrp | Optional | Group of elements |
OtherIntakeSystemInd | Required in the group | 1 (yes) or 0 (no) (1 when the original was filed outside IRIS) |
OtherIntakeSystemNm | Optional | Group of elements (FIRE, for example) |
UniqueRecordId | Optional | (the IRIS original's record ID) |
TIN | Optional | 9 digits, no dashes (original payee TIN) |
PersonName | Required in the group | Group of elements (original payee name (or BusinessName)) |
BusinessName | Required in the group | Group of elements |
RecipientDetail | Required | Group of elements |
RecipientAccountNum | Optional | Text, up to 30 characters |
IdentifiableEventDt | Optional | Date, YYYY-MM-DD |
DebtDischargeAmt | Optional | Amount, zero or more, up to 2 decimal places |
InterestAmt | Optional | Amount, zero or more, up to 2 decimal places |
DebtDesc | Optional | Text, up to 100 characters |
DebtorLiableDebtRepaymentInd | Required | 1 (yes) or 0 (no) |
IdentifiableEventCd | Required | One of: A, B, C, D, E, F, G, H |
FairMarketValueAmt | Optional | Amount, zero or more, up to 2 decimal places |
CSV template columns: the IRIS Taxpayer Portal upload
The portal takes Form 1099-C as a CSV upload built on the IRS template for the form. The tax year 2025 template has 43 columns (18 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 1099-C 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 column | Required | Format |
|---|---|---|---|
| A | Form Type | Optional | form type, filled in by the template |
| B | Tax Year | Optional | tax year |
| C | Creditor TIN Type | Required | TIN type: EIN, SSN |
| D | Creditor Taxpayer ID Number | Required | TIN with dashes (XX-XXXXXXX or XXX-XX-XXXX) |
| E | Creditor Name Type | Required | B (business) or I (individual): B, I |
| F | Creditor Business or Entity Name Line 1 | Optional | text; up to 40 characters |
| G | Creditor Business or Entity Name Line 2 | Optional | text; up to 40 characters |
| H | Creditor First Name | Optional | text; up to 20 characters |
| I | Creditor Middle Name | Optional | text; up to 20 characters |
| J | Creditor Last Name (Surname) | Optional | text; up to 20 characters |
| K | Creditor Suffix | Optional | text; up to 20 characters |
| L | Creditor Country | Required | country code (US for United States) |
| M | Creditor Address Line 1 | Required | text; up to 35 characters |
| N | Creditor Address Line 2 | Optional | text; up to 35 characters |
| O | Creditor City/Town | Required | text; up to 40 characters |
| P | Creditor State/Province/Territory | Required | two-letter state (or province, up to 17 characters); up to 17 characters |
| Q | Creditor ZIP/Postal Code | Required | ZIP: 5 or 9 digits, no dash; up to 9 characters |
| R | Creditor Phone Type | Optional | D (domestic) or I (international): D, I |
| S | Creditor Phone | Optional | phone, 10 digits |
| T | Debtor TIN Type | Optional | TIN type: ATIN, EIN, ITIN, QI-EIN, SSN, UND |
| U | Debtor Taxpayer ID Number | Optional | TIN with dashes (XX-XXXXXXX or XXX-XX-XXXX) |
| V | Debtor Name Type | Required | B (business) or I (individual): B, I |
| W | Debtor Business or Entity Name Line 1 | Optional | text; up to 40 characters |
| X | Debtor Business or Entity Name Line 2 | Optional | text; up to 40 characters |
| Y | Debtor First Name | Optional | text; up to 20 characters |
| Z | Debtor Middle Name | Optional | text; up to 20 characters |
| AA | Debtor Last Name (Surname) | Optional | text; up to 20 characters |
| AB | Debtor Suffix | Optional | text; up to 20 characters |
| AC | Debtor Country | Required | country code (US for United States) |
| AD | Debtor Address Line 1 | Required | text; up to 35 characters |
| AE | Debtor Address Line 2 | Optional | text; up to 35 characters |
| AF | Debtor City/Town | Required | text; up to 40 characters |
| AG | Debtor State/Province/Territory | Required | two-letter state (or province, up to 17 characters); up to 17 characters |
| AH | Debtor ZIP/Postal Code | Required | ZIP: 5 or 9 digits, no dash; up to 9 characters |
| AI | Office Code | Optional | 4 characters |
| AJ | Form Account Number | Optional | text; up to 20 characters |
| AK | Box 1 - Date of identifiable event | Required | MM/DD/YYYY |
| AL | Box 2 - Amount of debt discharged | Required | amount, no $ or commas |
| AM | Box 3 - Interest if included in Box 2 | Optional | amount, no $ or commas |
| AN | Box 4 - Debt description | Required | text; up to 100 characters |
| AO | Box 5 - If checked, the debtor was personally liable for repayment of the debt | Optional | Y or N |
| AP | Box 6 - Identifable event code | Required | text |
| AQ | Box 7 - Fair market value of property | Optional | amount, no $ or commas |
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.