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-CAP 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-CAP as a CSV upload, using the IRS template for the form.
In the tax year 2026 rule set: 1 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 |
|---|---|---|
| F1099CAP001 | Report error, reject over threshold | The aggregate amount received must be more than zero. |
Elements of Form1099CAPDetail
Each Form 1099-CAP return is one Form1099CAPDetail record in a submission of group 1. The table lists its 12 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.
| 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 |
RecipientDetail | Required | Group of elements |
RecipientAccountNum | Optional | Text, up to 30 characters |
SaleOrExchangeDt | Optional | Date, YYYY-MM-DD |
AggregateReceivedAmt | Optional | Amount, zero or more, up to 2 decimal places |
SharesExchangedCnt | Optional | Whole number, zero or more |
StockClassDesc | Optional | Text, up to 10 characters |
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.