API Reference

Submit Form 1099-MISC

post
https://{environment}.masspay.io/{VERSION}/payout//tax/form1099misc

This POST endpoint is used to submit a Form 1099-MISC (Miscellaneous Information) for a specific user identified by their user_token. The 1099-MISC form is used to report various types of miscellaneous income including rents, royalties, medical payments, and other income. Basic information (name, address, email, phone, TIN) is retrieved from the user's existing profile.

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

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.

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
Responses

404

Not Found

Updated 12 days ago

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

Updated 12 days ago

Did this page help you?