--- title: "Update or Correct Form 1099-MISC" method: PUT path: "/payout/{user_token}/tax/form1099misc" tags: ["Tax"] --- # Update or Correct Form 1099-MISC `PUT /payout/{user_token}/tax/form1099misc` ## Request - Base URL: `https://api.masspay.io/v1.0.0` - URL: `https://api.masspay.io/v1.0.0/payout/{user_token}/tax/form1099misc` - Auth: one of: - API key in header `Authorization` - API key in header `x-api-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Request body - Form1099MISCUpdateRequest: Form 1099-MISC submission (TaxBandits Form1099MISC/Create). Recipient name, TIN, address, email and phone come from the user's MassPay profile; EIN is used for a business user and SSN otherwise. At least one amount box, or the box 7 direct sales indicator, is required. Amounts are USD with two decimals. Boxes 13a (cash tips), 13b (tipped occupation codes) and 14 overtime compensation introduced for tax year 2026 are not accepted yet. - `tax_year` string, required: Tax year of the form. TaxBandits accepts 2023 through 2026; from tax year 2026 only IRIS filing is supported. - `rents` number: Box 1: Rents of $600 or more paid to the recipient (0 to 9999999999.99). - `royalties` number: Box 2: Gross royalty payments of $10 or more (0 to 9999999999.99). - `other_income` number: Box 3: Other income of $600 or more that does not belong in another box (0 to 9999999999.99). - `federal_tax_withheld` number: 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. - `fishing_boat_proceeds` number: Box 5: The individual's share of proceeds from the sale of a catch (0 to 9999999999.99). - `medical_healthcare_payments` number: Box 6: Medical and health care payments of $600 or more made to a provider (0 to 9999999999.99). - `is_direct_sale` 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. - `substitute_payments` number: Box 8: Substitute payments in lieu of dividends or interest of $10 or more (0 to 9999999999.99). - `crop_insurance` number: Box 9: Crop insurance proceeds of $600 or more paid to a farmer (0 to 9999999999.99). - `gross_proceeds_attorney` number: Box 10: Gross proceeds of $600 or more paid to an attorney for legal services (0 to 9999999999.99). - `fish_purchased_for_resale` number: 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). - `section_409a_deferrals` number: Box 12: Deferrals of $600 or more under a nonqualified deferred compensation plan, section 409A (0 to 9999999999.99). - `is_fatca` 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. - `excess_golden_parachute` number: 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. - `nonqualified_deferred_compensation` number: 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). - `account_number` string: 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. - `is_second_tin_notice` 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. - `is_postal` boolean: Whether TaxBandits should mail Copy B to the recipient's profile address (postage is added to the filing fee). Defaults to false. - `email_address` string, email: 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` StateFiling[]: 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_code` string: Two-letter state code (e.g., 'CA') - `state_name` string: Full state name (optional, for resolution) - `state_id_number` string: Payer's state ID number - `state_tax_withheld` number: State tax withheld - `state_income` number: State income (for NEC and MISC) - `submission_id` string, required: The original submission ID to update or correct - `is_void` 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. ## Response `200` OK - Form1099UpdateCorrectionResponse: Response from Form 1099 update or correction - `submission_id` string: The new submission ID - `record_id` string: The new record ID - `operation` 'UPDATE' | 'CORRECTION': Whether this was an update (pre-IRS acceptance) or correction (post-IRS acceptance) - `original_submission_id` string: The original submission ID that was updated/corrected - `status` 'SUCCESS' | 'FAILURE': Status of the operation ## Other responses - `400`: Bad request. - `401`: Unauthorized. - `403`: Forbidden. - `404`: Not Found - `405`: Method Not Allowed. - `500`: Internal server error. - `504`: Gateway Time-out. ## Changes - **2026-11-03** `f9fa41b7c45c`: 1 info - endpoint added [Operation history](https://skmtc.dev/masspay/apis/masspay-api/changes/payout/:user_token/tax/form1099misc/put.md) --- [API](https://skmtc.dev/masspay/apis/masspay-api.md) - [All operations](https://skmtc.dev/masspay/apis/masspay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/masspay/apis/masspay-api/revisions/f9fa41b7c45c?raw)