Version: 2.0

Update

This endpoint can be used to update the details on an existing 1099-INT 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 modify.

Key points

Your request JSON must include the SubmissionId and RecordId of the return you want to modify.
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.

POST form1099int/update

Run in Postman

Request Body

Field	Type	Description
SubmissionManifest	object[]	SubmissionManifest provides brief information about a particular submission on the whole. It contains information like Submission ID Tax Year IsScheduleFiling & ScheduleFiling service details
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission. Not required when you are creating a return.
TaxYear	string	Tax year of Form W2-G to be filed. Allowed values Allowed values: "2025", "2026"
IsScheduleFiling	Boolean	When true, schedule filing services will be enabled for Form W2-G returns under this submission.
ScheduleFiling	object[]	Optional Contains the preferred date to submit the returns to the IRS. Required only when "IsScheduleFiling" is True.
EfileDate	string	Date of Schedule Filing. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2026 or 01-25-2026
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Optional 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
IsDefaultBusiness	Boolean	When set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetails	object	TIN information for the business.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly.
TINType	string	Specify the TIN type of the business. Allowed values "EIN", "SSN"
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	Name control of the business as registered with the IRS. 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.
Address	object[]	Address information of the 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's province or state name. Allowed values When the country code is US: 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
Zipcd	string	DBA's ZIP code. Size Range: 5-16
Country	string	DBA's 2-character country code. Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI", "US"
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
ProvinceOrState	string	Province or state name of the business. Allowed values When the country code is US: 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the business. Size Range: 5-16
Country	string	2-character country code of the business. Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI", "US"
ContactDetails	object[]	Details of the person the IRS can contact regarding the given 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 The 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
Fax	string	Optional Fax number of the contact person. Size Range: 10 digits
ReturnData	object[]	Contains information about the recipient details and Form W2G details.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. Size Range: 50
RecordId	Guid	Unique Identifier of the Record. Mention the Form W2-G return's Record ID that you want to update. If you do not provide the Record ID, then a new record will be added to the submission.
ReturnManifest	object[]	Filing options for this record.
IsFederal	Boolean	Federal Filing for the return will be enabled when the value is True. Form W2G will be sent directly to the IRS.
IsState	Boolean	State Filing for the return will be enabled when the value is True. Form W2G will be directly filed with the respective recipient states. Note: State Filing will not be created for the states that do not require State filing.
IsDistribution	Boolean	When TRUE, recipient distribution is enabled (postal mail / online access/email).
DistributionDetails	object[]	Distribution configuration. Required when IsDistribution is TRUE.
DistributionType	string	Recipient copy distribution type. Allowed values "POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"
PostalType	string	Postal service type. Allowed values "USPS_FIRST_CLASS"
IsForced	Boolean	When TRUE, TaxBandits does not verify for duplicates and will create a new return for the recipient, even if it comprises the same amounts as in previously filed returns. For more information on duplicate handling for Form W2G, click here. Note: If there are multiple returns filed for the recipient with the same account number, TaxBandits will append 3 random numbers at the end of the account number.
Recipient	object	Object to identify the recipient details.
RecipientId	Guid	Optional A unique ID generated by TaxBandits after the return is created and will be returned in the Response. You can use this ID for your future reference to Update.
PayeeRef	string	Optional Your unique identifier for the recipient. Can replace RecipientId in future requests. Size Range: 50
TINDetails	object	Recipient TIN information.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly.
TINType	string	Specify the TIN type of the recipient. Allowed values "EIN", "SSN".
TIN	string	The TIN value, formatted according to the Format field 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 The 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	Name control of the business as registered with the IRS. Size Range: 3..4
DBADetails	object	Optional DBA (Doing Business As) information.
DBAId	Guid	TaxBandits-generated DBA identifier. Returned in the response.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Your unique identifier for this DBA. Size Range: 1–50
Address	object	Address information of the 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's province or state name. Allowed values When the country code is US: 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	DBA's ZIP code. Size Range: 5–16
Country	string	DBA's 2-character country code. Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI", "US"
DOB	string	Optional Date of Birth of the recipient. Format: MM/DD/YYYY
Address	object	Primary address 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 When the country code is US: 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" 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 "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI", "US"
Email	string	Email address of the recipient. Size Range: 100 Note: Required if DistributionType is ONLINE_ACCESS.
Fax	string	Optional Fax number of the recipient. Size Range: 10
Phone	string	Optional Phone number of the recipient. Size Range: 10
INTFormData	object	Recipient's Form 1099-INT information.
PayerRTN	number	Gets the routing and transit number (RTN), WHO wishes to participate in the program for direct deposit of refunds. It is Optional. Size Range: 9
IntIncome	number	Gets the taxable interest amounts of $10 or more which is not included in box 3 (Interest on U.S. Savings Bonds and Treas. Obligations). Size Range: 0-9999999999.99
EarlyWithdrawPenalty	number	Get the interest or principal forfeited because of an early withdrawal of time deposits. Size Range: 0-9999999999.99
IntOnUSBonds	number	Get the interest on U.S. Savings Bonds, Treasury bills, Treasury notes, and Treasury bonds. Size Range: 0-9999999999.99
FedTaxWH	number	Get the backup withholding, for the payments reported in box 1, box 2 and box 8 of this form. Size Range: 0-9999999999.99 Note: This value should be less than 40% of the sum of boxes 1, 3, 8.
InvestExp	number	Get the Investment Expenses. Size Range: 0-9999999999.99
ForeignTaxPaid	number	Get any foreign tax paid on interest. The amount should be in U.S. dollars. Size Range: 0-9999999999.99
ForeignCountry	string	Get the name of the foreign country or U.S. possession for which the foreign tax was paid and reported in box 6. Size Range: 2 Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
TaxExemptInt	number	Get the tax-exempt interest. Size Range: 0-9999999999.99
BondInt	number	Get the interest of $10 or more from specified private activity bonds. Size Range: 0-9999999999.99
MarketDisc	number	Get the amount of market discount that accrued on the debt instrument during the tax year in the amount of $10 or more. Size Range: 0-9999999999.99
BondPre	number	Get the amount of bond premium amortization allocable to the interest paid during the tax year for a taxable covered security acquired at a premium. Size Range: 0-9999999999.99
BondPreOnTreasOblig	number	Get the amount of bond premium amortization allocable to the interest paid during the tax year for a U.S. Treasury obligation that is a covered security. Size Range: 0-9999999999.99
BondPreOnTaxExempt	number	Get the amount of bond premium amortization allocable to the interest paid during the tax year for a tax-exempt covered security acquired at a premium. Size Range: 0-9999999999.99
USIP	string	For single bonds or accounts containing a single bond, get the CUSIP number of the tax-exempt bond for which tax-exempt interest is reported in box 8 or tax credit bond. Size Range: 13
IsFATCA	boolean	When true, identifies a U.S. payer reporting on Form(s) 1099 (including reporting payments on this Form 1099-INT) to satisfy their foreign financial asset reporting requirement with respect to a U.S. account.
AccountNum	string	Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-INT is filed. Optional. Account number assigned by the payer to distinguish the recipient's account. Size Range: 1–20 (or 4..20) Note: If the account number on the return you file is the same as any previously filed return, TaxBandits will append 3 random numbers at the end of the account number.
Is2ndTINnot	boolean	When true, identifies a Payer who is notified by the IRS twice within 3 calendar years for providing an incorrect TIN and do not want the IRS to send any more notices.
States	object []	Optional. State filing line-item data for the recipient. Required when ReturnManifest.IsState is TRUE.
StateCd	string	Two-letter state code where the income was earned, or the state filing applies. Size Range: 2
StateWH	number	Optional. State tax withheld. Size Range: 0–9999999999.99
StateIdNum	string	Optional. Payer's state identification number. Size Range: 1–20
StateIncome	number	Optional. State income. Size Range: 0–9999999999.99

Response Body

Field	Type	Description
BusinessId	Guid	Unique identifier 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 generated for the DBA.
ScheduleFiling	object	Returns the date of the schedule filing.
EFileDate	string	Date of the schedule filing to know when the return to be filed to the IRS.
Info	string	Information about Schedule Filing service.
Form1099Type	string	Denotes the type of form.
Form1099Records	object	Pulls Form W2G records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form W2G Records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record.
RecordId	Guid	An unique identifier generated by TaxBandits when a W2G return is created.
RecipientId	Guid	A unique reference ID for the submission that can be used to identify a particular record.
PayeeRef	string	Your unique identifier for the recipient, as provided in the request.
AccountNum	string	Account number of Payer having multiple accounts for a recipient for whom more than one Form W2G is filed.
Federal	object	Returns the record status and StatusTs of the federal return.
Status	string	Status of the operation.
StatusTs	string	Date and time of the return created.
Info	string	Returns information about the Federal Filing service.
State	object[]	Returns a collection of state return information.
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	Date and time of the postal creation.
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	Detailed status code.
StatusTs	string	Date and time of the postal created.
Info	string	Returns the information about the postal order.
OnlineAccess	object	Returns the Email address for whom the online access to be given and Status of online access.
Status	string	Returns status of online access for Form W2G 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 W2G Records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular DBA. The Sequence ID will be returned in the Response for your reference.
RecordId	Guid	Unique identifier of a record.
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.

Payload

Request Json

Sample	Description	Action
Sample 1	Create a Form 1099-INT return for the specific business and include recipient and income information.

Sample 1

{
  "SubmissionManifest": {
      "SubmissionId": "e50c27b8-631c-45f0-be19-f786fc69ba60",
      "TaxYear": "2026",
      "IsScheduleFiling": false,
      "ScheduleFiling": {
          "EfileDate": null
      }
  },
  "ReturnHeader": {
      "Business": {
          "PayerRef": "PAYER001",
          "BusinessId": null,
          "IsDefaultBusiness": true,
          "TINDetails": {
              "Format": "PLAIN_TIN",
              "TINType": "EIN",
              "TIN": "12-3456722"
          },
          "IndividualNm": {
              "FirstNm": "Robert",
              "MiddleNm": "M",
              "LastNm": "Johnson",
              "Suffix": null
          },
          "BusinessNm": "Summit Holdings Inc.",
          "NameCtrl": "SUMM",
          "DBADetails": {
              "DBANm": "Peak Consulting Group",
              "DBARef": "DBA2024",
              "DBAId": null,
              "IsDefaultDBA": true,
              "Address": {
                  "Address1": "4500 Corporate Drive",
                  "Address2": "Building B, Suite 200",
                  "City": "Charlotte",
                  "ProvinceOrState": "NC",
                  "ZipCd": "28217",
                  "Country": "US"
              }
          },
          "Email": "robert.johnson@summit.com",
          "Address": {
              "Address1": "4500 Corporate Drive",
              "Address2": "Building B, Suite 200",
              "City": "Charlotte",
              "ProvinceOrState": "NC",
              "ZipCd": "28217",
              "Country": "US"
          },
          "ContactDetails": {
              "FirstNm": "Robert",
              "MiddleNm": "M",
              "LastNm": "Johnson",
              "Suffix": null,
              "Phone": "7045558901",
              "PhoneExtn": null,
              "Email": "contact@summitholdings.com",
              "Fax": null
          }
      }
  },
  "ReturnData": [
      {
          "SequenceId": "1",
          "ReturnManifest": {
              "IsFederal": true,
              "IsState": true,
              "IsDistribution": true,
              "DistributionDetails": {
                  "DistributionType": "POSTAL_AND_ONLINE",
                  "PostalType": "USPS_FIRST_CLASS"
              },
              "IsForced": false
          },
          "Recipient": {
              "RecipientId": null,
              "PayeeRef": "PAYEE01",
              "TINDetails": {
                  "Format": "PLAIN_TIN",
                  "TINType": "SSN",
                  "TIN": "737-65-4340"
              },
              "NameCtrl": "MEGA",
              "IndividualNm": {
                  "FirstNm": "Sarah",
                  "MiddleNm": "E",
                  "LastNm": "Williams",
                  "Suffix": null
              },
              "BusinessNm": null,
              "DBADetails": {
                  "DBAId": null,
                  "DBANm": "Mega Enterprise",
                  "DBARef": "DBA2025",
                  "Address": {
                      "Address1": "789 Business Park Blvd",
                      "Address2": "Floor 12, Suite 1200",
                      "City": "Austin",
                      "ProvinceOrState": "TX",
                      "ZipCd": "78759",
                      "Country": "US"
                  }
              },
              "DOB": "01/02/1990",
              "Address": {
                  "Address1": "789 Business Park Blvd",
                  "Address2": "Floor 12, Suite 1200",
                  "City": "Austin",
                  "ProvinceOrState": "TX",
                  "ZipCd": "78759",
                  "Country": "US"
              },
              "Email": "sarah.williams@megacorp.com",
              "Fax": null,
              "Phone": "5125551234"
          },
          "INTFormData": {
              "PayerRTN": 106546867,
              "IntIncome": 901,
              "EarlyWithdrawPenalty": 78,
              "InterestOnUS": 98,
              "FedIncomeTaxWH": 56,
              "InvestExp": 89,
              "ForeignTaxPaid": 77,
              "ForeignCountry": "CA",
              "TaxExemptInterest": 99,
              "BondInterest": 22,
              "MarketDiscount": 999,
              "BondPre": 9999,
              "BondPreOnTreasOblig": 877,
              "BondPreOnTaxExempt": 9999,
              "USIPno": "87JJ767",
              "IsFATCA": true,
              "Is2ndTINnot": true,
              "AccountNum": "1121234",
              "States": [
                  {
                      "StateCd": "AZ",
                      "StateIdNum": "99-9999999",
                      "StateWH": 17
                  },
                  {
                      "StateCd": "CA",
                      "StateIdNum": "999999992",
                      "StateWH": 17
                  }
              ]
          }
      }
  ]
}

Response Json

Response	Description	Action
200	Success Response - This is a sample response for successful API requests.
401	Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.

Response: 200

{
"BusinessId": "bbd57dc2-d948-40cd-b67b-9fe06cc62218",
"PayerRef": null,
"DBARef": null,
"DBAId": null,
"SubmissionId": "e50c27b8-631c-45f0-be19-f786fc69ba60",
"ScheduleFiling": {
  "EfileDate": "01/25/2026"
},
"FormType": "W2G",
"FormW2Records": {
  "SuccessRecords": [
    {
      "SequenceId": "1",
      "RecordId": "cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b",
      "RecipientId": "4fb305b7-f0d7-4093-9152-93f07313b606",
      "PayeeRef": null,
      "AccountNum": "3534",
      "Federal": {
        "Status": "CREATED",
        "StatusCd": null,
        "StatusTs": "2026-01-02T02:17:04-05:00",
        "Info": null
      },
      "State": [
        {
          "StateCd": "AZ",
          "Status": "CREATED",
          "StatusCd": null,
          "StatusTs": "2026-01-02T02:17:04-05:00",
          "Info": "State filing created"
        }
      ],
      "Distribution": {
         "DistributionType": "POSTAL_ONLY",
        "Postal": {
          "PostalType": "USPS_FIRST_CLASS",
          "Status": "CREATED",
          "StatusCd": null,
          "StatusTs": "2026-01-02T02:17:04-05:00",
          "Info": "Postal order created"
        },
        "OnlineAccess": {
          "Status": "CREATED",
          "StatusCd": null,
          "Email": "shawn@sample.com",
          "Info": null
        }
      }
    }
  ],
  "ErrorRecords": [
    {
      "SequenceId": "2",
      "RecordId": null,
      "Errors": [
        {
          "Id": "RECPT-0013",
          "Name": "Recipient.FirstPayeeNm[0]",
          "Message": "FirstPayeeNm is required."
        }
      ]
    }
  ]
},
"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