Update or Correct Form 1099-MISC

This PUT endpoint is used to update or correct a previously submitted Form 1099-MISC. The system automatically determines whether to perform an Update (if the form has not yet been accepted by the IRS) or a Correction (if the form has already been accepted by the IRS). For corrections, specify correction_type as VOID, RECIPIENT, AMOUNT, or RECIPIENT_AMOUNT.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

Request body for updating or correcting Form 1099-MISC. The system automatically detects whether to Update (pre-IRS acceptance) or Correct (post-IRS acceptance).

string
required
^20[0-9]{2}$

Tax year of the form. TaxBandits accepts 2023 through 2026; from tax year 2026 only IRIS filing is supported.

number
0 to 9999999999.99

Box 1: Rents of $600 or more paid to the recipient (0 to 9999999999.99).

number
0 to 9999999999.99

Box 2: Gross royalty payments of $10 or more (0 to 9999999999.99).

number
0 to 9999999999.99

Box 3: Other income of $600 or more that does not belong in another box (0 to 9999999999.99).

number
0 to 9999999999.99

Box 4: Federal income tax withheld, including backup withholding (0 to 9999999999.99). TaxBandits rejects an amount of 40% or more of the sum of boxes 1, 2, 3, 5, 6, 8, 9 and 10. Defaults to 0.

number
0 to 9999999999.99

Box 5: The individual's share of proceeds from the sale of a catch (0 to 9999999999.99).

number
0 to 9999999999.99

Box 6: Medical and health care payments of $600 or more made to a provider (0 to 9999999999.99).

boolean

Box 7: true when the payer made $5,000 or more in direct sales of consumer products to the recipient for resale outside a permanent retail establishment. Defaults to false.

number
0 to 9999999999.99

Box 8: Substitute payments in lieu of dividends or interest of $10 or more (0 to 9999999999.99).

number
0 to 9999999999.99

Box 9: Crop insurance proceeds of $600 or more paid to a farmer (0 to 9999999999.99).

number
0 to 9999999999.99

Box 10: Gross proceeds of $600 or more paid to an attorney for legal services (0 to 9999999999.99).

number
0 to 9999999999.99

Box 11: Cash payments of $600 or more for fish purchased for resale from anyone in the trade of catching fish (0 to 9999999999.99).

number
0 to 9999999999.99

Box 12: Deferrals of $600 or more under a nonqualified deferred compensation plan, section 409A (0 to 9999999999.99).

boolean

Box 13: FATCA filing requirement; true when a U.S. payer reports to satisfy its foreign financial asset reporting requirement for a U.S. account. Defaults to false.

number
0 to 9999999999.99

Box 14: Excess golden parachute payments, the amount above the base amount (0 to 9999999999.99). Starting tax year 2025 the IRS moved this to Form 1099-NEC box 3; TaxBandits no longer reports it on the 1099-MISC for 2025 and later.

number
0 to 9999999999.99

Box 15: Nonqualified deferred compensation, including earnings, includible in income under section 409A because the plan fails the section 409A requirements (0 to 9999999999.99).

string
length ≤ 20

Optional payer account number that distinguishes a recipient with more than one 1099-MISC. TaxBandits requires 4 to 20 characters; MassPay removes any non-alphanumeric characters and truncates to 20, and TaxBandits appends three random digits when it matches a previously filed return.

boolean

Second TIN Notice: true when the IRS has notified the payer twice within three calendar years that the recipient's TIN is incorrect and the payer does not want further notices. Defaults to false.

boolean

Whether TaxBandits should mail Copy B to the recipient's profile address (postage is added to the filing fee). Defaults to false.

string

Optional email address to receive the tax form link; if provided, the form link will be sent to this address, and if omitted, no email will be sent.

state_filing
array of objects

State return details, one entry per state: two-letter state code, the payer's state ID number (up to 20 characters), state tax withheld and state income (each 0 to 9999999999.99). Supplying any entry files with those states.

state_filing
string
required

The original submission ID to update or correct

boolean

Set to true to VOID the original filing (zeros out all amounts). Use this when the form should not have been filed at all.

Responses

404

Not Found

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json