TIN ComplianceA resource from TIN Comply
IRIS form rules

IRIS Form 1099-DIV: rules and XML elements

What IRIS checks on Form 1099-DIV, Dividends and Distributions: the 5 business rules specific to this form for tax year 2026, with each rule's severity and what it checks, and the 30 elements of Form1099DIVDetail in the tax year 2026 XML record.

Submission group 1XML element Form1099DIVDetailElements 30, 7 required

These are errors and rejects every filer can get when sending information returns to IRIS, whether through the free IRIS Taxpayer Portal or through filing software. IRIS reports each one on the acknowledgment by rule number.

Form 1099-DIV 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-DIV as a CSV upload, using the IRS template for the form.

In the tax year 2026 rule set: 5 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.

RuleSeverityWhat it checks
F1099DIV001Report error, reject over thresholdTotal ordinary dividends cannot be less than qualified dividends, section 897 ordinary dividends, investment expenses and section 199A dividends combined.
F1099DIV002Report error, reject over thresholdIf qualified dividends are reported, total ordinary dividends are required.
F1099DIV003_001Report error, reject over thresholdTotal capital gain distributions must be at least the unrecaptured section 1250 gain, section 1202 gain, collectibles (28%) gain and section 897 capital gain combined.
F1099DIV004Report error, reject over thresholdFederal income tax withheld looks too high compared with the income amounts reported on the form.
F1099DIV005Report error, reject over thresholdExempt-interest dividends cannot be less than the specified private activity bond interest dividends.

Elements of Form1099DIVDetail

IRTransmission › IRSubmission1Grp › IRSubmission1Detail › Form1099DIVDetail

Each Form 1099-DIV return is one Form1099DIVDetail record in a submission of group 1. The table lists its 30 elements in schema order for tax year 2026: 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
CFSFElectionStateCdOptionalTwo-letter state or territory code
VoidIndRequired1 (yes) or 0 (no)
CorrectedIndRequired1 (yes) or 0 (no)
PrevSubmittedRecRecipientGrpOptionalGroup of elements
RecipientDetailRequiredGroup of elements
RecipientAccountNumOptionalText, up to 30 characters
FATCAFilingRequirementIndRequired1 (yes) or 0 (no)
SecondTINNoticeIndRequired1 (yes) or 0 (no)
TotalOrdinaryDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
QualifiedDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
TotalCapitalDistributionsAmtOptionalAmount, zero or more, up to 2 decimal places
UnrecapturedSection1250GainAmtOptionalAmount, zero or more, up to 2 decimal places
CapitalGainSect1202AmtOptionalAmount, zero or more, up to 2 decimal places
Collectibles28PercentGainAmtOptionalAmount, zero or more, up to 2 decimal places
Section897OrdinaryDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
Section897CapitalGainAmtOptionalAmount, zero or more, up to 2 decimal places
NondividendDistributionsAmtOptionalAmount, zero or more, up to 2 decimal places
FederalIncomeTaxWithheldAmtOptionalAmount, zero or more, up to 2 decimal places
Section199ADividendsAmtOptionalAmount, zero or more, up to 2 decimal places
InvestmentExpenseAmtOptionalAmount, zero or more, up to 2 decimal places
ForeignTaxesPaidAmtOptionalAmount, zero or more, up to 2 decimal places
ForeignCountryOrUSPossessionCdOptionalIRS two-letter country code
CashLiquidationDistriAmtOptionalAmount, zero or more, up to 2 decimal places
NoncashLiquidationDistriAmtOptionalAmount, zero or more, up to 2 decimal places
ExemptInterestDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
PrivateActivityBondIntDivAmtOptionalAmount, zero or more, up to 2 decimal places
StateLocalTaxGrpOptional, repeatsGroup of elements