Skip to main content
Version: 2.0.0

ValidateForm

ValidateForm

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

POST form1099divcorrection/validateform
Run in Postman

Request Body

FieldTypeDescription
SubmissionManifestobject[]SubmissionManifest provides brief information about a particular submission on the whole.
TaxYearstringTax year of Form 1099 DIV 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 Name of a person who could be contacted by the IRS if needed.
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 DIV 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-DIV will be sent directly to the IRS.
IsStateBooleanState Filing for the return will be enabled when the value is True. Form 1099-DIV 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-DIV 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-DIV that was originally filed with TaxBandits, provide the Record ID of the original Form 1099-DIV here. The PrevReportedRecipientData Object is not required if you provide the PrevReportedRecordID
OriginalFilingMethodStringFiling method used to submit the Form 1099-DIV 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-DIV. 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
DIVFormDataobjectForm 1099-DIV details for the recipient.
TotOrdiDivNumberGets dividends, including dividends from money market funds, net short-term capital gains from mutual funds, and other distributions on stock.Size Range: 0–9999999999.99
QualiDivNumberGets the portion of the dividends in box 1a that qualifies for the reduced capital gains rates.Size Range: 0–9999999999.99
TotCapGainNumberGet total capital gain distributions (long-term). Include all amounts shown in boxes 2b, 2c, 2d, and 2f.Size Range: 0–9999999999.99
UnRecapSecGainNumberGet any amount included in box 2a that is an unrecaptured section 1250 gain from certain depreciable real property.Size Range: 0–9999999999.99
Sec1202GainNumberGet any amount included in box 2a that is a section 1202 gain from certain qualified small business stock.Size Range: 0–9999999999.99
CollGainNumberGet any amount included in box 2a that is a 28% rate gain from sales or exchanges of collectibles.Size Range: 0–9999999999.99
Sec897OrdiDivNumberGet any amount included in box 1a that is section 897 gain from dispositions of USRPI.Size Range: 0–9999999999.99
Sec897CapGainNumberGet any amount included in box 2a that is section 897 gain from dispositions of USRPI.Size Range: 0–9999999999.99
NonDivDistNumberGet nondividend distributions, if determinable.Size Range: 0–9999999999.99
FedTaxWHNumberGet the backup withholding, for the payments reported in box1, box 2 and box 8 of this form.Size Range: 0–9999999999.99Note: Box 4 should be less than 40% of box 1a.
Sec199ADivNumberGet the qualified REIT dividends paid by a REIT or section 199A dividends paid by a RIC to the recipient.Size Range: 0–9999999999.99
InvestExpNumberGet the recipient's pro rata share of certain amounts deductible by a nonpublicly offered RIC in computing its taxable income.Size Range: 0–9999999999.99
ForeignTaxPaidNumberGet foreign tax paid on dividends and other distributions on stock.Size Range: 0–9999999999.99
ForeignCountryNumberGet the name of the foreign country or U.S. possession for which the foreign tax was paid and reported in box 7.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"

CashLiquiDistNumberGet cash distributed as part of a liquidation.Size Range: 0–9999999999.99
NonCashLiquiDistNumberGet noncash distributions made as part of a liquidation. Show the fair market value as of the date of distribution.Size Range: 0–9999999999.99
IsFATCABooleanWhen true, identifies a U.S. payer reporting on Form(s) 1099 (including reporting payments on this Form 1099-Div) to satisfy their foreign financial asset reporting requirement with respect to a U.S. account.
ExemptIntDivNumberGet exempt-interest dividends from a mutual fund or other RIC. Include specified private activity bond interest dividends in box 12 and in the total for box 11.Size Range: 0-9999999999.99
PrivActiBondIntDivNumberGet exempt-interest dividends paid by a RIC on specified private activity bonds to the extent that the dividends are attributable to interest on the bonds received by the RIC minus an allocable share of the expenses.Size Range: 0–9999999999.99
Is2ndTINnotBooleanWhen 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.
AccountNumStringOptional Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-DIV is filed.Size Range: 4..20Note: 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.
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
StateIncomenumberState income amount.
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 DIV 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-DIV 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"
    },
    "DIVFormData": {
      "TotOrdiDiv": 4998,
       "QualiDiv": 200,
       "TotCapGain": 2227,
        "UnRecapSecGain": 41.50,
        "Sec1202Gain": 42.60,
        "CollGain": 48.55,
        "Sec897OrdiDiv": 50.55,
        "Sec897CapGain": 3.55,
        "NonDivDist": 43.55,
        "FedTaxWH": 44.55,
         "Sec199ADiv": 45.55,
         "InvestExp": 46.55,
         "ForeignTaxPaid": 70.55,
         "ForeignCountry": "CA",
         "CashLiquiDist": 80.55,
         "NonCashLiquiDist": 90.55,
         "IsFATCA": false,
         "ExemptIntDiv": 40748.55,
         "PrivActiBondIntDiv": 23740.5,
         "Is2ndTINnot": false,
         "AccountNum": "20123130000009000001",
         "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
}