Skip to main content
Version: 2.0.0

ValidateForm

ValidateForm

Use this endpoint to validate 1099-SA 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 SA 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.
"TOKENIZED_TIN" — Pass tokenized TIN.

TINTypestringSpecify the TIN type of the business.
Allowed values

"EIN", "SSN"

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 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
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"

AddressobjectPrimary address of the business
Address1stringStreet address or PO Box of the business.
Size Range: 146
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"

ContactDetailsobjectDetails 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 SA 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-SA will be sent directly to the IRS.
IsStateBooleanState Filing for the return will be enabled when the value is True. Form 1099-SA 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-SA 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-SA that was originally filed with TaxBandits, provide the Record ID of the original Form 1099-SA here. The PrevReportedRecipientData Object is not required if you provide the PrevReportedRecordID
OriginalFilingMethodStringFiling method used to submit the Form 1099-SA 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.
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.
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-SA. 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.
• "TOKENIZED_TIN" — 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.
• "TOKENIZED_TIN" — 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
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.
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"

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.
ZipCdStringZIP code of the recipient.
Size Range: 5 – 16
CountryString2-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", "US", "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"
SAFormDataobjectRecipient's Form 1099-SA information.
GrossDistributionNumberGets the recipient's total amount of the distribution.This amount may have been a direct payment to the medical service provider or distributed to the recipient.
Size Range: 0–9999999999.99
EarningsOnExcessContNumberOptional Gets the earnings on any excess contributions that recipients withdrew from an HSA or Archer MSA by the due date of your income tax return.
Size Range: 0–9999999999.99
DistributionCodeStringGets the type of distribution.
Allowed values

"NORMAL_DIST", "EXCESS_CONTRIB", "DISABILITY","DEATH_DIST","PROHIBITED_TXN","DEATH_DIST_NONSPOUSE"

FMVOnDateOfDeathNumberGets the FMV of the recipient's account on the date of death.
Size Range: 0–9999999999.99
AccTypeStringRecipient's account type.
Allowed values

"HSA", "ARCHER_MSA", "MA_MSA"

AccountNumStringOptional Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-SA 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.

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 SA 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-SA return for the specific business and include recipient and income information.
Sample 1
{
  "SubmissionManifest": {
    "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"
      },
      "SAFormData": {
        "GrossDistribution": 966,
        "EarningsOnExcessCont": 0,
        "DistributionCode": "NORMAL_DIST",
        "FMVOnDateOfDeath": 53,
        "AccType": "HSA",
        "AccountNum": "HSA123456789"
      }
    }
  ]
}
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
}