Version: 2.0.0

Update

This endpoint can be used to update the details on an existing 1099-MISC return or to add additional returns under the same SubmissionId. Your request JSON must include the SubmissionId and RecordId of the return you want to modifys.

Key points

You cannot update a return once it has been transmitted, unless the return is in a ‘Scheduled’ status — scheduled forms can be updated until 11:59 PM ET of the previous day.90o9i8u7
The TaxYear of a submission cannot be changed once created. All other fields can be updated.

POST form1099misccorrection/update

Run in Postman

Request Body

Field	Type	Description
SubmissionManifest	object[]	SubmissionManifest provides brief information about a particular submission on the whole.
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission.
TaxYear	string	Tax year of Form 1099-MISC Correction to be filed. Allowed values "2025", "2026"
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business details.
BusinessId	Guid	Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
PayerRef	string	Optional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
TINDetails	object	TIN information for the business
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "ENCRYPTED_TIN" — Pass encrypted TIN. "TOKENIZED_TIN" — Pass tokenized TIN.
TINType	string	Specify the TIN type of the business. Allowed values "EIN", "SSN", "ATIN", "ITIN", "IRSN", "QI-EIN", "WP-EIN", "WT-EIN", "NQI-EIN"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional Middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional Suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	IRS name control of the business. Size Range: 3..4
DBADetails	object[]	Optional DBA (Doing Business As) information.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Unique identifier for the DBA. Size Range: 1-50
DBAId	Guid	TaxBandits generated DBA identifier. Use the unique DBA ID generated by TaxBandits that you received in the response of the Business/AddDBA Endpoint. If you do not have a DBA ID, ignore the field. By giving the DBA ID, you do not have to provide all the DBA information again.
IsDefaultDBA	Boolean	When TRUE, marks this DBA as the default.
Address	object[]	Address information of DBA
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrStateNm	string	DBA province or state name. Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP", "OC", "XX", "TT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the DBA. Size Range: 5-16
Country	string	2-character country code of the business. Allowed values "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"
Email	string	Optional Email address of the Business. Size Range: 100
Address	object[]	Primary address of the business
Address1	string	Street address or PO Box of the business. Size Range: 46
Address2	string	Optional Suite or apartment number of the business. Size Range: 46
City	string	City of the business. Size Range: 50
ProvinceOrStateNm	string	Province or state name of the business. Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP", "OC", "XX", "TT" Note: The size range is set to 50 for all countries except the ZIP code of Canada.
ZipCd	string	ZIP code of the business. Size Range: 5-16
Country	string	2-character country code of the business. Allowed values "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"
ContactDetails	object[]	Details of the person the IRS can contact regarding this business.
FirstNm	string	First name of the contact person. Size Range: 20
MiddleNm	string	Optional Middle name of the contact person. Size Range: 20
LastNm	string	Last name of the contact person. Size Range: 20
Suffix	string	Optional Suffix of the contact person. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	string	Optional Phone number of the contact person. Size Range: 10 digits
PhoneExtn	string	Optional Phone extension number. Size Range: 5
Email	string	Optional Email address of the contact person. Size Range: 100
Fax	string	Optional Fax number of the contact person. Size Range: 10 digits
ReturnData	object[]	Contains information about the recipient details and Form 1099 details
SequenceId	string	Optional A unique reference ID for the return that can be used to identify a particular record. The Sequence ID will be returned in the response for your reference. Size Range: 50
ReturnManifest	object[]	Return level manifests and filing services.
IsFederal	Boolean	Federal Filing for the return will be enabled when the value is True. Form 1099-MISC will be sent directly to the IRS.
IsState	Boolean	State Filing for the return will be enabled when the value is True. Form 1099-MISC will be directly filed with the respective recipient states.
IsDistribution	Boolean	When TRUE, recipient distribution is enabled (postal mail / online access).
DistributionDetails	object	Recipient distribution configuration. Required when IsDistribution is TRUE.
DistributionType	string	Recipient copy distribution type. Allowed values "ONLINE_ACCESS", "POSTAL_AND_ONLINE", "POSTAL_ONLY"
PostalType	string	Postal service type. Allowed values "USPS_FIRST_CLASS"
CorrectionDetails	object	Object containing the information required to identify the correction type for the Form 1099-MISC update or the Form 1099-MISC correction type to be filed.
FederalCorrectionType	string	Provide the type of correction for federal filing you are filing for the recipient. Allowed values "VOID" - The form shouldn't have been filed. "RECIPIENT" - Correcting only the recipient details, such as Name and TIN. "AMOUNT" - Correcting only the amount fields, including check boxes and account. "RECIPIENT_AND_AMOUNT" - Correcting both recipient details and amount-related fields, including Name, TIN, account, check box values and codes. "ADDRESS_ONLY" - Correcting only recipient address information.
PrevReportedRecordId	Guid	If you are correcting a 1099-MISC that was originally filed with TaxBandits, provide the Record ID of the original Form 1099-MISC here. The PrevReportedRecipientData object is not required if you provide the PrevReportedRecordId.
OriginalFilingMethod	string	Filing method used to submit the Form 1099-MISC return to the IRS. Not required when the return is processed through TaxBandits. Allowed values "IRIS", "FIRE"
IRISUniqueIds	object	Gets the IRS unique identifier associated with the previously filed original return.
UTID	string	An Unique Transmission Identifier (UTID) used to track the original return.
ReceiptId	string	Receipt Id that confirms IRS received the transmission.
SubmissionId	string	An identifier that represents a specific submission within a transmission.
RecordId	string	An identifier that represents an individual return within a submission.
PrevReportedRecipientData	object	Object containing the recipient information that was submitted in the original Form 1099-MISC. The information is not required if you have provided the PrevReportedRecordId.
RecipientId	string	Optional A unique ID generated by TaxBandits after the recipient is created and will be returned in the response.
TINDetails	object	Recipient TIN information.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "ENCRYPTED_TIN" — Pass encrypted TIN. "TOKENIZED_TIN" — Pass tokenized TIN.
TINType	string	Specify the TIN type of the recipient. Allowed values "EIN", "SSN", "ATIN", "ITIN", "IRSN", "QI-EIN", "WP-EIN", "WT-EIN", "NQI-EIN"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional Middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional The suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the recipient business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	IRS name control of the recipient. Size Range: 3..4
CorrectRecipientData	object	If the corrected Recipient Name and TIN info fails, this object is required where "RECIPIENT", "ADDRESS_ONLY", or "RECIPIENT_AND_AMOUNT" is passed as FederalCorrectionType. The object should be "null" when the CorrectionType value is "VOID" or "AMOUNT".
TINDetails	object	Recipient TIN information.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "ENCRYPTED_TIN" — Pass encrypted TIN. "TOKENIZED_TIN" — Pass tokenized TIN.
TINType	string	Specify the TIN type of the recipient.
TIN	string	The TIN value according to the format selected.
IndividualNm	object	Required when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional Middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional The suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the recipient business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	IRS name control of the recipient. Size Range: 3..4
DBADetails	object	Optional DBA (Doing Business As) information.
DBAId	Guid	TaxBandits generated DBA identifier. Use the unique DBA ID generated by TaxBandits that you received in the response of the Business CREATE/DBA Endpoint if you want to reuse it. If you do not have a DBA ID, ignore the field. By giving the DBA ID, you do not have to provide all the DBA information again.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Your unique identifier for the DBA. Size Range: 1-50
Address	object	Primary address of DBA
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrState	string	DBA province or state name. Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP", "OC", "XX", "TT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the DBA. Size Range: 5-16
Country	string	2-character country code of the recipient. Allowed values "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"
Address	object[]	Primary address or PO Box of the recipient
Address1	string	Street address or PO Box of the recipient. Size Range: 46
Address2	string	Optional Suite or apartment number of the recipient. Size Range: 46
City	string	City of the recipient. Size Range: 50
ProvinceOrState	string	Province or state name of the recipient. Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP", "OC", "XX", "TT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the recipient. Size Range: 5-16
Country	string	2-character country code of the recipient. Allowed values "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"
Email	string	Email address of the recipient. Size Range: 100 Note: DistributionType is either "ONLINE_ACCESS" or "POSTAL_AND_ONLINE".
Fax	string	Optional Fax number of the recipient. Size Range: 10
Phone	string	Optional Phone number of the recipient. Size Range: 10
MISCFormData	object[]	Form 1099-MISC data for the recipient
Rents	number	Amount of rent paid to the recipient that exceeds the reporting threshold. The threshold is $600 for tax years before 2026 and $2,000 for tax years 2026 and later. Size Range: 0-9999999999.99
Royalties	number	Gets the gross royalty payments valuing $10 or more paid to the recipient. Size Range: 0-9999999999.99
OtherIncome	number	Amount of other income paid to the recipient that exceeds the reporting threshold and cannot be reported in any other box on the form. The threshold is $600 for tax years before 2026 and $2,000 for tax years 2026 and later. Size Range: 0-9999999999.99
FedIncomeTaxWH	number	Federal income tax withheld. Gets the backup withholding. For example, persons who have not furnished their TIN to their employer are subject to backup withholding of payments required to be reported in boxes 1, 2, 3, 5, 6, 8, 9 and 10. Size Range: 0-9999999999.99
FishingBoatProceeds	number	Fishing boat proceeds. Gets an individual's share of all proceeds from the sale of a catch. Size Range: 0-9999999999.99
MedHealthcarePymts	number	Medical and health care payments. Gets the payments made in excess of $600 or more to a physician, other supplier or provider of medical or health care services. Size Range: 0-9999999999.99
IsDirectSales	Boolean	Payer made direct sales of $5,000 or more of consumer products to a buyer for resale. When true, identifies the payer who made $5,000 or more of selling consumer products to a person on a buy-sell, deposit-commission, or other commission basis for resale.
SubstitutePymts	number	Substitute payments in lieu of dividends or interest. Gets the aggregate payments of at least $10 of substitute payments received by a broker for a customer in lieu of dividends or tax-exempt interest as a result of a loan of a customer's securities. Size Range: 0-9999999999.99
CropInsurance	number	Gets the crop insurance proceeds of $600 or more paid to farmers by insurance companies. Size Range: 0-9999999999.99
GrossProceeds	number	Gets the gross proceeds in excess of $600 paid to an attorney in connection with legal services, regardless of services performed for the payer. Size Range: 0-9999999999.99
FishPurForResale	number	Gets the total cash payments of $600 or more paid during the year to any person who is engaged in the trade or business of catching fish. Size Range: 0-9999999999.99
Sec409ADeferrals	number	Gets the total amount deferred during the year of at least $600 for the nonemployee under all nonqualified plans. Size Range: 0-9999999999.99
CashTips	number	Cash tips are paid to the recipient. Size Range: 0-9999999999.99 Note: This field is applicable for TY 2026
TTOC1	string	Treasury Tipped Occupation code 1. Note: This field is applicable for TY 2026
TTOC2	string	Treasury Tipped Occupation code 2. Note: This field is applicable for TY 2026
OvertimeComp	number	Overtime compensation. Size Range: 0-9999999999.99 Note: This field is applicable for TY 2026
IsFATCA	Boolean	When true, it identifies a U.S. payer reporting on Form(s) 1099 (including reporting payments on this Form 1099-MISC) to satisfy their foreign financial asset reporting requirement with respect to a U.S. account.
EPP	number	Excess golden parachute payments. Specify the amount over the base amount (the average annual compensation for services includible in the individual's gross income over the most recent 5 tax years). Size Range: 0-9999999999.99 Note: Starting tax year 2028, this amount is reported in Form 1099-MISC.
NonQualDefComp	number	Nonqualified deferred compensation. Gets the amounts deferred that are includible in income under section 409A because the nonqualified deferred compensation plan fails to satisfy the requirements of section 409A. Size Range: 0-9999999999.99
Is2ndTINNot	Boolean	When TRUE, indicates the payer was notified by the IRS twice within 3 calendar years of an incorrect TIN and does not want further notices.
AccountNum	string	Optional Account number used when filing multiple 1099-MISCs for one recipient.
States	object[]	List of state filing details.
StateCorrectionType	string	Specify the type of state correction you are filing. Allowed values "VOID" - The state return was submitted incorrectly and should not have been processed. "CORRECTION" - Used to correct previously reported amounts or codes. "NA" - Used when no information needs correction or the state correction is not applicable.
StateCd	string	2-character state code. Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY"
StateIdNum	string	State income tax identification number. Size Range: 0-9999999999
StateWH	number	State income tax withheld. Size Range: 0-9999999999.99
StateIncome	number	State income amount. Size Range: 0-9999999999.99

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
BusinessId	Guid	Unique identifier of the business generated by TaxBandits. Store this for use in all subsequent requests.
PayerRef	string	Your unique identifier for the payer, as provided in the request.
DBARef	string	Your unique identifier for the DBA.
DBAId	Guid	Unique identifier of the DBA generated by TaxBandits.
Form1099Type	string	Denotes the type of 1099 correction form.
Form1099Records	object	Pulls Form 1099-MISC records with Success and Error statuses
SuccessRecords	object[]	It will show the detailed information about the success status of Form 1099-MISC Records
SequenceId	string	A unique reference ID for the return that can be used to identify a particular record.
PrevReportedRecordId	Guid	Record ID of the original Form 1099-MISC which is given while creating Form 1099 MISC correction.
RecordId	Guid	An unique identifier generated by TaxBandits when a 1099-MISC return is created.
RecipientId	Guid	A unique ID generated by TaxBandits after the recipient is created
PayeeRef	string	Your unique identifier for the recipient, as provided in the request.
FederalReturn	object	Returns the record status and StatusTs of the federal return.
Status	string	Status of the operation.
StatusCd	string	Predefined status code for the status
StatusTs	string	Date and time of the return created.
Info	string	Returns information about the Federal Filing service.
State	object[]	Returns a collection of status and StatusTs of the State returns.
StateCd	string	Returns the state code of the state for which the return is filed.
Status	string	Returns the record status of the state return.
StatusCd	string	Predefined status code for the status
StatusTs	string	Date and time of the return created.
Info	string	Returns the information about the return processed for the state.
Distribution	object[]	Returns information about the distribution.
DistributionType	string	Returns the distribution method used.
Postal	object[]	Returns information about postal mailing.
PostalType	string	Returns the postal service used.
Status	string	Returns the Postal status.
StatusCd	string	Predefined status code for the status
StatusTs	string	Date and time of the postal created.
Info	string	Returns the information about the postal order.
OnlineAccess	object	Returns information about Online access.
Status	string	Returns status of online access for Form 1099-MISC return.
Email	string	Email address for whom the online access to be given.
Info	string	Information about the online access service.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 1099-MISC Records.
SequenceId	string	A unique reference ID for the return that can be used to identify a particular record.
RecordId	Guid	An unique identifier generated by TaxBandits when a 1099-MISC return is created.
Errors	Object[]	Validation error details.
Id	String	Validation error code.
Name	String	Name of the validation rule that failed.
Message	String	Clear description of what went wrong and how to fix it.
Errors	Object[]	Top-level request errors if the entire request cannot be processed.
Id	String	Validation error code.
Name	String	Name of the validation rule that failed.
Message	String	Clear description of what went wrong and how to fix it.

Request Json

Sample	Description	Action
Sample 1	Update 1099-MISC Correction – Federal and State Correction as VOID
Sample 2	Update 1099-MISC Correction – Federal Correction as RECIPIENT
Sample 3	Update 1099-MISC Correction – Federal Correction as ADDRESS_ONLY
Sample 4	Update 1099-MISC Correction – Federal RECIPIENT_AMOUNT with State Correction as NEW and CORRECTION
Sample 5	Update 1099-MISC Correction – Federal Correction as AMOUNT
Sample 6	Update 1099-MISC Correction – Outfiler Filer

Sample 1

{
  "SubmissionManifest": {
    "SubmissionId": "7bd46527-75f1-4ddd-88a1-1cbc951912d5",
    "TaxYear": "2026",
    "IsFederal": true,
    "IsState": true,
    "IsDistribution": true,
    "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
    }
  },
  "ReturnHeader": {
    "Business": {
      "BusinessId": "229429ba-da91-4e6f-96e9-0932849d6025",
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "72-5564875"
      },
      "IndividualNm": null,
      "BusinessNm": "Horizon LLC",
      "NameCtrl": "HORI",
      "DBADetails": null,
      "Address": {
        "Address1": "2500 Horizon Parkway",
        "Address2": "Suite 200",
        "City": "Plano",
        "ProvinceOrState": "TX",
        "ZipCd": "75024",
        "Country": "US"
      },
      "ContactDetails": {
        "FirstNm": "Michael",
        "MiddleNm": "A",
        "LastNm": "Carter",
        "Suffix": "Jr",
        "Phone": "9725550100",
        "PhoneExtn": "205",
        "Email": "horizonllc@sample.com",
        "Fax": "9725550199"
      }
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "RecordId": "4c6a371c-49fa-49de-9c8f-8fd1db2856a0",
      "ReturnManifest": {
        "IsFederal": true,
        "IsState": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_ONLY",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "CorrectionDetails": {
          "FederalCorrectionType": "VOID",
          "PrevReportedRecordId": "0ff9c322-0b0b-4343-a9ab-22768db58c2a",
          "OriginalFilingMethod": "IRIS",
          "IRISUniqueIds": null
        }
      },
      "PrevReportedRecipientData": {
        "RecipientId": "8a187169-ed18-40f9-9691-9516e128da37",
        "PayeeRef": "746347",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "SSN",
          "TIN": "587-41-9263"
        },
        "IndividualNm": {
          "FirstNm": "David",
          "MiddleNm": "R",
          "LastNm": "Thompson",
          "Suffix": null
        },
        "NameCtrl": null,
        "BusinessNm": null
      },
      "CorrectRecipientData": {
        "PayeeRef": "746347",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "SSN",
          "TIN": "587-41-9263"
        },
        "IndividualNm": {
          "FirstNm": "David",
          "MiddleNm": "R",
          "LastNm": "Thompson",
          "Suffix": null
        },
        "NameCtrl": null,
        "BusinessNm": null,
        "DBADetails": null,
        "Address": {
          "Address1": "780 Main Street",
          "Address2": "Unit 12",
          "City": "Charleston",
          "ProvinceOrState": "WV",
          "ZipCd": "25301",
          "Country": "US"
        },
        "Email": "henry@sample.com"
      },
      "MISCFormData": {
        "Rents": 0,
        "Royalties": 0,
        "OtherIncome": 0,
        "FedIncomeTaxWH": 0,
        "FishingBoatProceeds": 0,
        "MedHealthcarePymts": 0,
        "IsDirectSale": false,
        "SubstitutePymts": 0,
        "CropInsurance": 0,
        "GrossProceeds": 0,
        "FishPurForResale": 0,
        "Sec409ADeferrals": 0,
        "CashTips": 0,
        "TTOC1": "501",
        "TTOC2": "502",
        "OvertimeComp": 8750,
        "IsFATCA": true,
        "NonQualDefComp": 15800,
        "AccountNum": "1234567890123456",
        "Is2ndTINnot": true,
        "States": [
          {
            "StateCd": "AZ",
            "StateIdNum": "999999999",
            "StateCorrectionType": "VOID",
            "StateWH": 0,
            "StateIncome": 0
          }
        ]
      }
    }
  ]
}

Response Json

Sample	Description	Action
200	Success Response - This is a sample response for successful API requests.
207	Partial Success Response - This is a sample response when one or more records are created successfully and one or more records fail validation.
400	Bad Request Response - This is a sample response when the request cannot be processed because of validation errors.
401	Unauthorized Response - This is a sample response when the access token is missing, expired, or invalid.

Response: 200

{
  "SubmissionId": "42d28856-0b8d-43c7-815d-150a063a8ee1",
  "BusinessId": "e6981dbb-9600-4b76-ae93-2e5db31b00f6",
  "PayerRef": null,
  "DBARef": null,
  "DBAId": null,
  "Form1099Type": "MISCCorrection",
  "Form1099Records": {
    "SuccessRecords": [
      {
        "SequenceId": "1",
        "RecordId": "b53439fe-5eb6-46dd-b651-6f7ba22ec54a",
        "PrevReportedRecordId": null,
        "RecipientId": "295a5b6d-1bbf-4f16-a1a0-33daeebf72bf",
        "PayeeRef": "34535447",
        "Federal": {
          "Status": "CREATED",
          "StatusCd": "FED_001",
          "StatusTs": "2026-08-21 07:37:20 -04:00",
          "Info": "Return created successfully",
          "Errors": null
        },
        "State": [
          {
            "StateCd": "AK",
            "Status": "NOT_CREATED",
            "StatusCd": "STATE_000",
            "StatusTs": "2026-08-21 07:37:20 -04:00",
            "Info": "State filing is not required for this submission",
            "Errors": null
          },
          {
            "StateCd": "IN",
            "Status": "CREATED",
            "StatusCd": "STATE_001",
            "StatusTs": "2026-08-21 07:37:20 -04:00",
            "Info": "State filing will be sent directly to the state department",
            "Errors": null
          }
        ],
        "Distribution": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "Postal": {
            "PostalType": "USPS_FIRST_CLASS",
            "Status": "CREATED",
            "StatusCd": "POSTAL_001",
            "StatusTs": "2026-08-21 07:37:20 -04:00",
            "Info": "Postal order created"
          },
          "OnlineAccess": {
            "Status": "CREATED",
            "StatusCd": "ONLINE_001",
            "Email": "henry@sample.com",
            "Info": "Online access order initiated successfully"
          }
        }
      }
    ],
    "ErrorRecords": null
  },
  "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Update

Update

Key points​

Request Body

Response Body

Sample 1

Response: 200

Key points