Skip to main content
Version: 2.0.0

ValidateForm

ValidateForm

Use this endpoint to validate 1099-INT Correction data against IRS business rules before creating the form.

POST form1099intcorrection/validateform
Run in Postman

Request Body

FieldTypeDescription
SubmissionManifestobject[]SubmissionManifest provides brief information about a particular submission on the whole.
TaxYearstringTax year of Form 1099 INT Correction to be filed.
Allowed values

"2025", "2026"

ReturnHeaderobjectContains information about the Business details.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidUse 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.
PayerRefstringOptional Your unique identifier for the payer. Can replace BusinessId in future requests.
Size Range: 50
TINDetailsobjectTIN information for the business
FormatstringSpecifies how the TIN is passed.
Allowed values

"PLAIN_TIN" — Pass TIN directly.
"ENCRYPTED_TIN" — Pass encrypted TIN.
"TOKENIZED_TIN" — Pass tokenized TIN.

TINTypestringSpecify the TIN type of the business.
Allowed values

"EIN", "SSN", “QI-EIN”, “ITIN”, “WP-EIN”, “WT-EIN”, “NQI-EIN”, “IRSN”

TINstringThe TIN value according to the Format selected.
IndividualNmobjectRequired when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNmstringThe first name of the individual.
Size Range: 20
MiddleNmstringOptional Middle name of the individual.
Size Range: 20
LastNmstringThe last name of the individual.
Size Range: 20
SuffixstringOptional Optional Suffix of the individual’s name.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

BusinessNmstringLegal name of the business. Required when TINType is EIN.
Size Range: 75
NameCtrlnumberIRS name control of the business.
Size Range: 3..4
DBADetailsobject[]Optional DBA (Doing Business As) information.
DBANmstringName of the DBA.
Size Range: 75
DBARefstringUnique identifier for the DBA.
*Size Range: 1-50
DBAIdGUIDTaxBandits-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.
IsDefaultDBABooleanWhen TRUE, marks this DBA as the default.
Addressobject[]Address information of DBA
Address1stringStreet address or PO Box.

Size Range: 46
Address2stringOptional Suite or apartment number.

Size Range: 46
CitystringDBA’s city.

Size Range: 50
CitystringDBA’s city.

Size Range: 50
ProvinceOrStateNmstringDBA's province or state name.
Allowed values

When the country code is CA: "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:“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.
ZipcdstringDBA’s ZIP code.

Size Range: 5-16
ZipcdstringDBA’s ZIP code.

Size Range: 5-16
CountrystringDBA’s 2-character country code.
Allowed values

“US”,"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"

EmailstringOptional Email address of the Business

Size Range: 100
AddressobjectPrimary address of the business
Address1stringStreet address or PO Box of the business.

Size Range: 46
Address2stringOptional Suite or apartment number of the business.

Size Range: 46
CitystringCity of the business.

Size Range: 50
ProvinceOrStateNmstringProvince or state name of the business.
Allowed values

When the country code is US : "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: “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.
ZipCdstringZIP code of the business.

Size Range: 5-16
Countrystring2-character country code of the business.
Allowed values

“US”,"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"

ContactDetailsobject[]Details of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person.

Size Range: 20
MiddleNmstringOptional Middle name of the contact person.

Size Range: 20
LastNmstringLast name of the contact person.

Size Range: 20
SuffixstringOptional The suffix of the contact person.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

PhonestringOptional Phone number of the contact person

Size Range: 10
PhoneExtnstringOptional Phone extension number.

Size Range: 5
EmailstringOptional Email address of the contact person.

Size Range: ...100
FaxstringOptional Fax number of the contact person.

Size Range: 10 digits
ReturnDataobject[]Contains information about the recipient details and Form 1099 INT correction details.
SequenceIdstringOptional 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
ReturnManifestobject[]Return Manifest provides a high-level summary of a return. It includes information such as the federal filing, state filing, postal service, recipient copy distribution configuration, correction type, and the IRIS unique identifiers associated with the return.
IsFederalBooleanFederal Filing for the return will be enabled when the value is True. Form 1099-INT will be sent directly to the IRS.
IsStateBooleanState Filing for the return will be enabled when the value is True. Form 1099-INT 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.
IsDistributionBooleanWhen TRUE, recipient distribution is enabled (postal mail / online access/email).
DistributionDetailsobject[]Recipient distribution configuration. Required when IsDistribution is TRUE.
DistributionTypestringRecipient copy distribution type.
Allowed values

"POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"

PostalTypestringPostal service type.
Allowed values

“USPS_FIRST_CLASS”

CorrectionDetailsObjectObject containing the information required to identify the correction type for the Form 1099-INT return
FederalCorrectionTypestringProvide 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 codes.
RECIPIENT_AMOUNT - Correcting both recipient details and amount-related fields, including Name, TIN, amounts, check boxes, and codes.
ADDRESS_ONLY - Correcting only recipient address information

PrevReportedRecordIdGuidIf you are correcting a 1099-INT that was originally filed with TaxBandits, provide the Record ID of the original Form 1099-INT here. The PrevReportedRecipientData Object is not required if you provide the PrevReportedRecordID
OriginalFilingMethodStringFiling method used to submit the Form 1099-INT return to the IRS (Not required when the return is processed through TaxBandits)
Allowed values

"IRIS", "FIRE"

IRISUniqueIdsObjectGets the IRIS unique identifiers associated with the previously filed original return.

Note: IRISUniqueIds is required only if the original return was filed using the IRIS filing format, but it is not required if the original return was already filed through TaxBandits.
UTIDStringGets the IRIS unique identifiers associated with the previously filed original return.An Unique Transmission Identifier (UTID) used to track the original return
ReceiptIdStringAn identifier that confirms IRIS received the transmission.
SubmissionIdStringAn identifier that represents a specific submission within a transmission.
RecordIdStringAn identifier that represents an Indivdual return within a submission.
PrevReportedRecipientDataobjectObject containing the recipient information that was submitted in the Original Form 1099-INT. The information is not required if you have provided the PrevReportedRecordId.
RecipientIdGuidOptional A unique ID generated by TaxBandits after the recipient is created and will be returned in the Response.
PayeeRefstringOptional Your unique identifier for the recipient.

Size Range: 50
TINDetailsobjectRecipient TIN information.
FormatstringSpecifies how the TIN is passed.
Allowed values

• "PLAIN_TIN" — Pass TIN directly.
• "ENCRYPTED" — Pass encrypted TIN.
• "TOKEN" — Pass tokenized TIN.

TINTypestringSpecify the TIN type of the recipient.
Allowed values

""EIN", "SSN", "ATIN", "ITIN", "NA"

TINstringTIN value according to the Format selected.
IndividualNmObjectRequired when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNmstringThe first name of the individual.

Size Range: 20
MiddleNmstringOptional The middle name of the individual.

Size Range: 20
LastNmstringThe last name of the individual.
Size Range: 20
SuffixstringOptional The suffix of the individual’s name.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

BusinessNmstringLegal name of the recipient business. Required when TINType is EIN.
Size Range: 75
NameCtrlstringIRS name control of the recipient.
Size Range: 3..4
CorrectRecipientDataobjectEnter the corrected Recipient Name and TIN value. This Object is required, when the CorrectionType value is "RECIPIENT" or "RECIPIENT_AMOUNT" or "ADDRESS_ONLY" (only for recipient's address correction). The object should be "null", when the CorrectionType value is "VOID" or "AMOUNT"
TINDetailsobjectRecipient TIN information.
FormatstringSpecifies how the TIN is passed.
Allowed values

• "PLAIN_TIN" — Pass TIN directly.
• "ENCRYPTED" — Pass encrypted TIN.
• "TOKEN" — Pass tokenized TIN.

TINTypestringSpecify the TIN type of the recipient.
Allowed values

"EIN", "SSN", “QI-EIN”, “ITIN”, “WP-EIN”, “WT-EIN”, “NQI-EIN”, “IRSN”

TINstringTIN value according to the Format selected.
IndividualNmObjectRequired when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
FirstNmStringThe first name of the individual.
Size Range: 20
MiddleNmStringOptional The middle name of the individual.
Size Range: 20
LastNmStringThe last name of the individual.
Size Range: 20
SuffixStringOptional The suffix of the individual’s name.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

BusinessNmStringLegal name of the recipient business. Required when TINType is EIN.
Size Range: 75
NameCtrlStringIRS name control of the recipient.
Size Range: 3..4
DBADetailsObjectOptional DBA (Doing Business As) information.
DBAIdGUIDTaxBandits-generated DBA identifier. Use the unique DBA ID (Generated by TaxBandits) that you received in the response of the Recipient/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.
DBANmStringName of the DBA.
Size Range: 75
DBARefStringYour unique identifier for this DBA.
Size Range: 1–50 characters
AddressObjectAddress information of DBA
Address1StringStreet address or PO Box.

Size Range: 46
Address2StringOptional Suite or apartment number.

Size Range: 46
CityStringDBA’s city.

Size Range: 50
ProvinceOrStateStringDBA’s province or state name.
Allowed values

When the country code is US : "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:“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.
ZipCdStringZIP code of the business.

Size Range: 5 - 16
CountryStringDBA’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"

AddressObjectPrimary address of the recipient.
Address1StringStreet address or PO Box of the recipient.
Size Range: 46
Address2StringOptional Suite or apartment number of the recipient.
Size Range: 46
CityStringCity of the recipient.
Size Range: 50
ProvinceOrStateStringProvince or state name of the recipient.
Allowed values

When the country code is US : "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: “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.
ZipCdStringDBA’s ZIP code.
Size Range: 5 – 16
CountryStringDBA’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"

EmailStringEmail address of the recipient.
Size Range: 100

Note: Required if the DistributionType is either "ONLINE_ACCESS" or "POSTAL_AND_ONLINE"
FaxStringOptional Fax number of the recipient.
Size Range: 10
PhoneStringOptional Phone number of the recipient.
Size Range: 10
INTFormDataobjectForm 1099-INT details for the recipient.
PayerRTNNumberGets the routing and transit number (RTN), WHO wishes to participate in the program for direct deposit of refunds. It is Optional.
Size Range: 9
IntIncomeNumberGets 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
EarlyWithdrawPenaltyNumberGet the interest or principal forfeited because of an early withdrawal of time deposits.
Size Range: 0–9999999999.99
IntOnUSBondsNumberGet the interest on U.S. Savings Bonds, Treasury bills, Treasury notes, and Treasury bonds.
Size Range: 0–9999999999.99
FedTaxWHNumberGet 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.
InvestExpNumberGet the Investment Expenses.
Size Range: 0–9999999999.99
ForeignTaxPaidNumberGet any foreign tax paid on interest. The amount should be in U.S. dollars.
Size Range: 0–9999999999.99
ForeignCountryStringGet the name of the foreign country or U.S. possession for which the foreign tax was paid and reported in box 6.
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"

TaxExemptIntNumberGet the tax-exempt interest.
Size Range: 0–9999999999.99
BondIntNumberGet the interest of $10 or more from specified private activity bonds.
Size Range: 0–9999999999.99
MarketDiscNumberGet 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
BondPreNumberGet 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
BondPreOnTreasObligNumberGet 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
BondPreOnTaxExemptNumberGet 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
CUSIPnoStringFor 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
IsFATCABooleanWhen 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.
AccountNumstringOptional 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.
Is2ndTINnotBooleanOptional 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.
Statesobject[]List of state filing details.
StateCorrectionTypeStringSpecify the type of state correction you are filing.
Allowed values

VOID - The state filing was submitted incorrectly and should not have been processed
CORRECTION - Used to correct previously reported amounts or codes
NEW - Used to add new state information that was not included in the original filing.

Note: To update a previously filed state, you must first indicate the original state as VOID, then add the new state using the NEW correction type.
StateCdstring2-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", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"

StateIdNumstringPayer’s state identification number.
Size Range: ..20
StateWHnumberState income tax withheld.
Size Range: 0-9999999999.99

Response Body

FieldTypeDescription
StatusCodeNumberFax number of the recipient.Returns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
ErrorRecordsobject[]It will show the detailed information about the error status of Form 1099 INT Records.
SequenceIdstringShows detailed error information.
Errorsobject[]Shows detailed error information
IdstringReturns the validation error Id
NamestringName of the validation error
MessagestringDescription of the validation error
ErrorsObject []Top-level request errors if the entire request cannot be processed.
IdStringValidation error code.
NameStringName of the validation rule that failed.
MessageStringClear description of what went wrong and how to fix it.
Request Json
SampleDescriptionAction
Sample 1
Create a Form 1099-INT return for the specific business and include recipient and income information.
Sample 1
{
  "SubmissionManifest": {
    "SubmissionId": "f561a414-c92f-4026-9c29-71cd1979bf72",
    "TaxYear": "2026"
  },
  "ReturnHeader": {
    "Business": {
      "BusinessId": null,
      "PayerRef": "Snow123",
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "45-9875461"
      },
      "IndividualNm": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr"
      },
      "BusinessNm": "Snowdaze LLC",
      "NameCtrl": "SNOW",
      "DBADetails": {
        "DBANm": "Iceberg Icecreams",
        "DBARef": "DBA1001",
        "DBAId": null,
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        }
      },
      "Email": "james@sample.com",
      "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 1001",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCd": "29730",
        "Country": "US"
      },
      "ContactDetails": {
        "FirstNm": "James",
        "MiddleNm": "A",
        "LastNm": "Anderson",
        "Suffix": "Jr",
        "Phone": "8035551234",
        "PhoneExtn": "101",
        "Email": "contact@snowdaze.com",
        "Fax": "8035555678"
      }
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "ReturnManifest": {
        "IsFederal": true,
        "IsState": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_ONLY",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "CorrectionDetails": {
          "FederalCorrectionType": "RECIPIENT",
          "PrevReportedRecordId": null,
          "OriginalFilingMethod": "IRIS",
          "IRISUniqueIds": {
            "UTID": "37f44812-b4ed-4255-aba2-afc13a56493a:IRIS:DB7RM::A",
            "ReceiptId": "2024-65384464963-c12b927aa",
            "SubmissionId": "66522383",
            "RecordId": "98517992"
          }
        }
      },
      "PrevReportedRecipientData": {
        "RecipientId": null,
        "PayeeRef": "DAI001",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
        },
        "NameCtrl": null,
        "BusinessNm": "Dairy Delights LLC",
        "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
        }
      },
      "CorrectRecipientData": {
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-9875461"
        },
        "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
        },
        "BusinessNm": "Dairy Delights LLC",
        "NameCtrl": null,
        "DBADetails": {
          "DBAId": null,
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 1001",
            "City": "Rock Hill",
            "ProvinceOrState": "SC",
            "ZipCd": "29730",
            "Country": "US"
          }
        },
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        },
        "Email": "shawn@sample.com",
        "Fax": "6634567890",
        "Phone": "9634567890"
      },
      "INTFormData": {
        "PayerRTN": 106546867,
        "IntIncome": 901.54,
        "EarlyWithdrawPenalty": 0,
        "InterestOnUS": 0,
        "FedIncomeTaxWH": 0,
        "InvestExp": 0,
        "ForeignTaxPaid": 0,
        "ForeignCountry": null,
        "TaxExemptInterest": 0,
        "BondInterest": 0,
        "MarketDiscount": 0,
        "BondPre": 0,
        "BondPreOnTreasOblig": 0,
        "BondPreOnTaxExempt": 0,
        "CUSIPno": null,
        "IsFATCA": false,
        "Is2ndTINnot": false,
        "AccountNum": "1121234234234",
        "States": [
          {
            "StateCorrectionType": "NEW",
            "StateCd": "CA",
            "StateIdNum": "Z9999999",
            "StateWH": 14.55
          }
        ]
      }
    }
  ]
}
Response Json
ResponseDescriptionAction
200
Success Response - This is a sample response for successful API requests.
400
Bad Request Response - You'll get the below response when your API requests contain any validation errors.
401
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
Response: 200
{
  "StatusCode": 200,
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "ErrorRecords": null,
  "Errors": null
}