Skip to main content
Version: 2.0.0

ValidateForm

ValidateForm

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

POST form1099bcorrection/validateform
Run in Postman

Request Body

FieldTypeDescription
SubmissionManifestobject[]SubmissionManifest provides brief information about a particular submission on the whole.
TaxYearstringTax year of Form 1099 B 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.
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
ProvinceOrStatestringDBA'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
ProvinceOrStatestringProvince 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 B 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-B will be sent directly to the IRS.
IsStateBooleanState Filing for the return will be enabled when the value is True. Form 1099-B 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-B 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-B that was originally filed with TaxBandits, provide the Record ID of the original Form 1099-B here. The PrevReportedRecipientData Object is not required if you provide the PrevReportedRecordID
OriginalFilingMethodStringFiling method used to submit the Form 1099-B 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-B. 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
BFormDataobjectForm 1099-B details for the recipient.
DescrOfPropStringEnter the issuer's name and the number of shares or units you held that were exchanged. Size Range: 39
DateAcquiredStringEnter the date of acquisition in the format MM/DD/YYYY. Size Range: 10
DateSoldOrDisposedStringFor broker transactions, enter the trade date of the transaction. For barter exchanges, enter the date when cash, property, a credit, or scrip is actually or constructively received in MM/DD/YYYY format. Size Range: 10
ProceedsNumberEnter the gross cash proceeds from all dispositions (including short sales) of securities, commodities, options, securities futures contracts, or forward contracts. Size Range: 0-9999999999.99
CostOrOtherBasisNumberEnter the adjusted basis of any securities sold unless the security is not a covered security. Size Range: 0-9999999999.99
AccruedMktDiscNumberEnter the amount of accrued market discount. Size Range: 0-9999999999.99
WashsaleLossDisallowedNumberReport wash sale loss amount disallowed. Size Range: 0-9999999999.99
TypeOfGainLossEnumEnter the type of Gain or Loss.
Allowed values

"SHORT TERM", "LONG TERM", "ORDINARY SHORT TERM", "ORDINARY LONG TERM"

IsProceedsFromCollectiblesBooleanWhen true, identifies reporting proceeds from Collectibles.
IsProceedsFromQOFBooleanWhen true, identifies reporting proceeds from Qualified Opportunity Fund.
FedTaxWHNumberEnter backup withholding. Size Range: 0-9999999999.99
Note: This value should be less than 40% of box 1d.
IsNonCoveredSecurityNotReportedBooleanWhen true, identifies that noncovered security Basis not reported to the IRS
IsNonCoveredSecurityReportedBooleanWhen true, identifies that noncovered security Basis reported to the IRS
IsGrossProceedsBooleanWhen true, identifies gross proceeds.
IsNetProceedsBooleanWhen true, identifies net proceeds.
IsLossNotAllowedbasedOn1dBooleanWhen true, identifies recipient is unable to claim a loss on their tax return based on proceeds.
PLRealizedOnClosedContractNumberEnter the profit or (loss) realized by the customer on closed regulated futures, foreign currency, or Section 1256 option contracts in following tax year. Size Range: 0-9999999999.99
PLUnrealizedOnOpenContractPrevTyNumberEnter the unrealized profit or (loss) on open regulated futures, foreign currency, or Section 1256 option contracts at the end of following tax year. Size Range: 0-9999999999.99
UnrealizedPLOpenContractCurTyNumberEnter the unrealized profit or (loss) on open regulated futures, foreign currency, or Section 1256 option contracts at the end of following tax year. Size Range: 0-9999999999.99
AggPLOnContractNumberEnter the aggregate profit or (loss) for the year from regulated futures, foreign currency, or Section 1256 option contracts. Size Range: 0-9999999999.99
IsBasisReportedToIRSBooleanWhen true, identifies that not checking box 5, or checking box 5 but reporting basis to the IRS in box 1e anyway.
BarteringNumberEnter the gross amounts received by a member or client of a barter exchange. Size Range: 0-9999999999.99
Form8949CodeStringEnter a one-letter code that will assist the recipient in reporting the transaction on Form 8949 and/or Schedule D (Form 1040).
Allowed values

"A", "B", "C", "E", "X"

CUSIPNumStringFor transactional reporting by brokers, enter the CUSIP number of the security or other applicable identifying number. Size Range: 13
AccountNumStringOptional Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-B is filed. Size Range: 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.
IsFATCABooleanWhen true, identifies a U.S. payer reporting on Form(s) 1099 (including reporting payments on this Form 1099-B) to satisfy their foreign financial asset reporting requirement with respect to a U.S. account.
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.
Statesobject[]List of state filing details.

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 B 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-B 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"
    },
    "BFormData": {
      "DescrOfProp": "100 Shares of ABC Corporation",
       "DateAcquired": "03/15/2026",
       "DateSoldOrDisposed": "06/15/2026",
        "Proceeds": 2500.75,
        "CostOrOtherBasis": 1800.00,
        "AccruedMktDisc": 12.30,
        "WashsaleLossDisallowed": 25,
        "TypeOfGainLoss": "ORDINARY SHORT TERM",
        "IsProceedsFromCollectibles": true,
        "IsProceedsFromQOF": false,
        "FedTaxWH": 150,
         "IsNonCoveredSecurityNotReported": false,
         "IsNonCoveredSecurityReported": true,
         "IsGrossProceeds": true,
         "IsNetProceeds": false,
         "IsLossNotAllowedbasedOn1d": false,
         "IsBasisReportedToIRS": true,
         "Bartering": 0,
         "Form8949Code": "A",
         "CUSIPNum": "037833100",
         "Is2ndTINnot": false,
         "AccountNum": "ACC789121",
         "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
}