IRISfile
Get notified

1099 amount-code lookup

Pick a form and a paper box, and get the Publication 1220 payment amount code plus the IRIS XML element that carries it. Or pick a code and read the other way. All seven forms, in one table. Free, no signup.

Showing 2 of 2 1099-NEC codes.

Pub 1220 payment amount codes for 1099-NEC with paper box numbers and IRIS XML elements
CodeBoxPub 1220 descriptionIRIS element
11Nonemployee compensationNonemployeeCompensationAmt
44Federal income tax withheldFederalIncomeTaxWithheldAmt

Why amount codes are not box numbers

In a Pub 1220 file the money fields are keyed by payment amount code, running 1 through 9 then A through J, with I skipped. Those codes are not the box numbers printed on the paper form. On some forms the two match. On others they diverge hard, and the filing still passes schema validation with the dollars in the wrong place.

The worst case is 1099-DIV. Federal income tax withheld is box 4 on paper but amount code A in the file, and there is no DIV code 4 at all. A converter that maps by box number writes withholding into a code that does not exist or, worse, into another code's element. The Publication 1220 vs 5718 guide works through the full conversion trap.

1099-INT crosses one pair relative to box order: code E (bond premium on Treasury obligations) is box 12, while code D (bond premium on tax-exempt bonds) is box 13. 1099-MISC scatters its lettered codes: code E is box 15, code D is box 12, code F is box 11. 1099-R hides its last two codes behind sub-boxes: code 9 is box 9b (box 9a is a percentage, not dollars) and code B is box 10. 1099-B uses sub-boxes throughout: code 2 is box 1d, code 3 is box 1e, code D is box 1f, code 5 is box 1g.

Where each column comes from

Code and description come from Publication 1220 (Rev. 5-2026), via our internal code-to-element reference. The IRIS element comes from the official TY2025 XSD for each form, via the generator tables that render real returns. An automated test pins every element on this page against those tables, so the name you copy is the name the transmitter sends.

Box numbers for 1099-NEC, MISC and INT come from the official IRS Portal template headers encoded in our filing code. Box numbers for the other four forms come from the IRS instructions for that form: 1099-DIV instructions (01/2024), 1099-R instructions (2026), 1099-B instructions (2026), and Form 1099-S (Rev. April 2025). Any box this page could not source would show as n/a with a note. None currently does.

What a developer does with it

The internal record is Form1099Record, and its amounts map is keyed by Pub 1220 code, not by box. DIV withholding goes in amounts['A'], INT Treasury bond premium in amounts['E'], R total employee contributions in amounts['9']. The generator maps each code to its named XSD element in document order.

Read the table backwards to audit a file: an element name tells you the code, and the code tells you which paper box the dollars came from. A code the form does not permit never reaches XML. Validation rejects it first, so a mis-keyed box is an error you see, not a misfiled return. The FIRE-to-IRIS guide shows where this check sits in the pipeline.

Questions

Are Pub 1220 amount codes the same as the box numbers on the paper form?
No. On a 1099-DIV, federal income tax withheld is box 4 on paper but amount code A in the file, and there is no DIV code 4 at all. On a 1099-INT, code E is box 12 and code D is box 13, crossed relative to box order. On a 1099-MISC the lettered codes land far from their letters: code E is box 15. File by code, never by box.
Where do the IRIS element names come from?
From the official TY2025 IRIS XSD for each form, through the generator tables in our own filing code. Every element in this lookup is pinned by an automated test against the FORM_BODY table that renders real returns, so the name you copy is the name our transmitter sends.
How do I file a dollar amount under one of these codes?
Put it in the amounts map of Form1099Record under the code, for example amounts['A'] for DIV federal withholding. The generator maps each code to its named XSD element. A code the form does not permit is rejected at validation, so a misfiled box fails loudly instead of landing in the wrong element.
Why are 1099-B and 1099-S listed if IRISfile does not file them?
Because the map is the point. IRISfile files 1099-NEC, MISC, INT and DIV originals, plus 1099-R when the record carries a box 7 distribution code. 1099-S, 1099-B, corrections and voids are not filed yet. Their codes, boxes and elements are still published here so a preparer or developer can line the three up.
Which keys does the table skip, and why?
Three app-level keys that are not Pub 1220 payment amount codes: NEC box 2 (the direct-sales checkbox, stored as amounts['2']=1), MISC box 7 (the same checkbox), and NEC box 5 (state tax withheld, routed to a StateLocalTaxGrp). They ride in the same amounts map for plumbing reasons and carry no IRIS amount element.
Did the 1099-S boxes change?
Yes. On the TY2025 form, gross proceeds are box 2 and the buyer's part of real estate tax is box 6. The Rev. December 2026 form splits gross proceeds into boxes 2a, 2b and 2c, moves the buyer's tax to box 4, and reserves box 5. The Pub 1220 codes did not move: gross proceeds are still code 2 and the buyer's tax is still code 5.

Last verified September 20, 2026 against Publication 1220 (Rev. 5-2026), the 1099-DIV instructions (01/2024), 1099-R instructions (2026), 1099-B instructions (2026), Form 1099-S (Rev. April 2025) and the current 1099-S instructions (12/2026). Product coverage follows the verified product facts: NEC, MISC, INT and DIV originals plus 1099-R with a box 7 distribution code file today; 1099-S, 1099-B, corrections and voids do not file yet.

Codes mapped. File clean originals instead of fixing them.

Get notified