Skip to main content
Version: 2.0.0

Create

Create

Use this endpoint to create one or more Form 1099-A returns in a single submission. You can create up to 250 returns for a payer in a single request. When the request is successful, you’ll receive a SubmissionId, which uniquely identifies that submission.

TaxBandits lets you configure filing and distribution services at two levels:

  • Submission level (SubmissionManifest)- Applies default settings for every return in the submission.
  • Return level (ReturnManifest, inside each ReturnData entry) - Lets you override those defaults for a specific recipient's return.

Filing services​

  • Federal Filing - Set IsFederal to TRUE to e-file the return with the IRS.
  • State Filing - Set IsState to TRUE to file with the relevant state agency. State filing will not be created for states that do not require it.
  • State-only filing - Set IsState to TRUE and IsFederal to FALSE. Use this when the federal return has already been filed outside of TaxBandits.

Distribution services​

Enable recipient copy distribution by setting IsDistribution to TRUE and configuring DistributionDetails:

  • Postal Mailing - Set DistributionType to POSTAL_ONLY and PostalType to USPS_FIRST_CLASS. TaxBandits prints and mails the recipient copy via USPS First Class on your behalf.
  • Online Access - Set DistributionType to ONLINE_ACCESS. The recipient's Email is required. They will be notified via email and can view and download their copy through a secure online portal.

If you want to enable both Postal Mailing and Online Access, set DistributionType to POSTAL_AND_ONLINE.

POST Form1099A/Create
Run in Postman

Request Body

FieldTypeDescription
SubmissionManifestobject[]SubmissionManifest provides brief information about a particular submission on the whole.
It contains information like
  • Submission ID
  • Tax Year
  • IsScheduleFiling & ScheduleFiling service details
TaxYearstringTax year of Form 1099-A to be filed.
Allowed values

Allowed values: "2025", "2026"

IsFederalBooleanFederal Filing will be enabled when the value is True. Form 1099-A will be sent directly to the IRS.
IsStateBooleanState Filing will be enabled when the value is True. Form 1099-A 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[]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"

IsScheduleFilingBooleanWhen true, schedule filing services will be enabled for Form 1099-A returns under this submission.
ScheduleFilingobject[]Optional Contains the preferred date to submit the returns to the IRS.
Required only when "IsScheduleFiling" is True.
EfileDatestringDate of Schedule Filing. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY.
Example: 01/25/2026 or 01-25-2026
ReturnHeaderobjectContains information about the Business details.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidOptional Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
PayerRefstringOptional Your unique identifier for the payer. Can replace BusinessId in future requests.
Size Range: 50
IsDefaultBusinessBooleanWhen set to TRUE, this business will be set as the default across requests that do not specify a business.
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","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 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
NameCtrlstringName control of the business as registered with the IRS.
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.
Addressobject[]Address information of the 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:
Allowed values

"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"

When the country code is CA:
Allowed values

"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT"

Note: The size range is set to 50 for all countries except the United States and Canada.
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: 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:
Allowed values

"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"

When the country code is CA:
Allowed values

"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT"

Note: The size range is set to 50 for all countries except the United States and Canada.
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 digits
PhoneExtnstringOptional Phone extension number.
Size Range: 5
FaxstringOptional Fax number of the contact person.
Size Range: 10 digits
ReturnDataobject[]Contains information about the recipient details and Form 1099-A details.
SequenceIdstringA unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference.
Size Range: 50
ReturnManifestobject[]Filing options for this record.
IsFederalBooleanFederal Filing for the return will be enabled when the value is True. Form 1099-A will be sent directly to the IRS.
IsStateBooleanState Filing for the return will be enabled when the value is True. Form 1099-A 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[]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"

IsForcedBooleanWhen TRUE, TaxBandits does not verify for duplicates and will create a new return for the recipient, even if it comprises the same amounts as in previously filed returns. For more information on duplicate handling for Form 1099s, click here.

Note: If there are multiple returns filed for the recipient with the same account number, TaxBandits will append 3 random numbers at the end of the account number.
RecipientobjectObject to identify the recipient details.
RecipientIdGuidOptional A unique ID generated by TaxBandits after the return is created and will be returned in the Response. You can use this ID for your future reference to Update.
PayeeRefstringOptional Your unique identifier for the recipient. Can replace RecipientId in future requests.
Size Range: 50
TINDetailsobjectRecipient TIN information.
FormatstringSpecifies how the TIN is passed.
Allowed values

"PLAIN_TIN" — Pass TIN directly.

TINTypestringSpecify the TIN type of the recipient.
Allowed values

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

TINstringThe TIN value, formatted according to the Format field 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
NameCtrlstringName control of the business as registered with the IRS.
Size Range: 3..4
DBADetailsobjectOptional DBA (Doing Business As) information.
DBAIdGuidTaxBandits-generated DBA identifier. Returned in the response.
DBANmstringName of the DBA.
Size Range: 75
DBARefstringYour unique identifier for this DBA.
Size Range: 1–50
AddressobjectAddress information of the 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:
Allowed values

"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"

When the country code is CA:
Allowed values

"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT"

Note: The size range is set to 50 for all countries except the United States and Canada.
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"

DOBstringOptional Date of Birth of the recipient.
Format: MM/DD/YYYY
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:
Allowed values

"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"

When the country code is CA:
Allowed values

"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT"

Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCdstringZIP code of the recipient.
Size Range: 5 – 16
Countrystring2-character country code of the recipient.
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"

EmailstringEmail address of the recipient.
Size Range: 100
Note: Required if DistributionType is ONLINE_ACCESS.
FaxstringOptional Fax number of the recipient.
Size Range: 10
PhonestringOptional Phone number of the recipient.
Size Range: 10
AFormDataobjectRecipient's Form 1099-A information.
AcqDtstringThe date the lender acquired the secured property, or the date the lender first knew or had reason to know that the property was abandoned. This is generally the earlier of the date title was transferred to the lender or the date possession and the benefits and burdens of ownership were transferred to the lender - for example, the date of a foreclosure or execution sale, or the date the right of redemption or objection period expired (Form 1099-A, Box 1 - Date of Lender's Acquisition or Knowledge of Abandonment).Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY
Example: 01/25/2026 or 01-25-2026
BalOutStandingNumberThe balance of principal outstanding on the debt at the time the interest in the property was acquired, or on the date the lender first knew or had reason to know the property was abandoned (Form 1099-A, Box 2 - Balance of Principal Outstanding). Include only unpaid principal on the original debt; do not include accrued interest or foreclosure costs.
Size Range: 0–9999999999.99
FMVNumberOptional The fair market value (FMV) of the property as of the date entered in AcqDt (Form 1099-A, Box 4 - Fair Market Value (FMV) of Property). For a foreclosure, execution, or similar sale, this is generally the gross foreclosure bid/sale price. For an abandonment or voluntary conveyance to the lender in lieu of foreclosure, enter the appraised value of the property only if IsBorrowerLiable is True; otherwise leave this field blank.
Size Range: 0–9999999999.99
IsBorrowerLiableBooleanIf True, indicates the borrower was personally liable for repayment of the debt at the time the debt was created, or if modified, at the time of the last modification (Form 1099-A, Box 5 - Was Borrower Personally Liable for Repayment of the Debt).
PropDescstringOptional A description of the property (Form 1099-A, Box 6 - Description of Property). For real property, provide the address; if the address doesn't sufficiently identify the property, include the section, lot, and block. For personal property, describe the type, make, and model.
Size Range: ..39
AccountNumStringOptional Account number (used when filing multiple 1099-As for one recipient).
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.

Response Body

FieldTypeDescription
BusinessIdGuidUnique identifier generated by TaxBandits. Store this for use in all subsequent requests.
PayerRefstringYour unique identifier for the payer, as provided in the request.
DBARefstringYour unique identifier for the DBA.
DBAIdGuidUnique identifier generated for the DBA.
ScheduleFilingobjectReturns the date of the schedule filing.
EFileDatestringDate of the schedule filing to know when the return to be filed to the IRS.
Form1099TypestringDenotes the type of 1099 form.
Form1099RecordsobjectPulls Form 1099-A records with Success and Error statuses.
SuccessRecordsobject[]It will show the detailed information about the success status of Form 1099-A Records.
SequenceIdstringA unique reference ID for the submission that can be used to identify a particular record.
RecordIdGuidAn unique identifier generated by TaxBandits when a 1099-A return is created.
RecipientIdGuidA unique reference ID for the submission that can be used to identify a particular record.
PayeeRefstringYour unique identifier for the recipient, as provided in the request.
AccountNumstringAccount number of Payer having multiple accounts for a recipient for whom more than one Form 1099-A is filed.
FederalobjectReturns the record status and StatusTs of the federal return.
StatusstringStatus of the operation.
StatusTsstringDate and time of the return created.
InfostringReturns information about the Federal Filing service.
Distributionobject[]Returns information about the distribution.
DistributionTypestringReturns the distribution method used.
Postalobject[]Returns information about postal mailing.
PostalTypestringReturns the postal service used.
StatusstringReturns the Postal status.
StatusCdstringDetailed status code.
StatusTsstringDate and time of the postal created.
InfostringReturns the information about the postal order.
OnlineAccessobjectReturns the Email address for whom the online access to be given and Status of online access.
StatusstringReturns status of online access for Form 1099-A return.
EmailstringEmail address for whom the online access to be given.
InfostringInformation about the online access service.
object[]It will show the detailed information about the error status of Form 1099-A Records.
SequenceIdstringA unique reference ID for the submission that can be used to identify a particular DBA. The Sequence ID will be returned in the Response for your reference.
RecordIdGuidUnique identifier of a record.
Errorsobject[]Validation error details.
IdstringValidation error code.
NamestringName of the validation rule that failed.
MessagestringClear description of what went wrong and how to fix it.
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
Business – EIN, Recipient – SSN (Individual)
Sample 2
Business – SSN (Individual), Recipient – EIN
Sample 3
1099A Using the Tokenized TIN
Sample 4
Multiple 1099A’s in the Single Payload
Sample 5
1099 A Using the BusinessId and RecipientId
Sample 6
Filing Another 1099A with same Data with IsForced Set as True
Sample 1
{
  "SubmissionManifest": {
    "TaxYear": "2026",
    "IsFederal": true,
    "IsState": true,
    "IsDistribution": true,
    "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
    },
    "IsScheduleFiling": false,
    "ScheduleFiling": null
  },
  "ReturnHeader": {
    "Business": {
      "BusinessId": null,
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "72-5564874"
      },
      "IndividualNm": null,
      "BusinessNm": "Horizon LLC",
      "NameCtrl": "HORI",
      "DBADetails": null,
      "Address": {
        "Address1": "2500 Horizon Parkway",
        "Address2": "Suite 200",
        "City": "Plano",
        "ProvinceOrState": "TX",
        "ZipCd": "75024",
        "Country": "US"
      },
      "ContactDetails": {
        "FirstNm": "Michael",
        "MiddleNm": "A",
        "LastNm": "Carter",
        "Suffix": "Jr",
        "Phone": "9725550100",
        "PhoneExtn": "205",
        "Email": "horizonllc@sample.com",
        "Fax": "9725550199"
      }
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "ReturnManifest": {
        "IsFederal": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "IsForced": false
      },
      "Recipient": {
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "SSN",
          "TIN": "321-44-5782"
        },
        "BusinessNm": null,
        "NameCtrl": "THOM",
        "IndividualNm": {
          "FirstNm": "David",
          "MiddleNm": "R",
          "LastNm": "Thompson",
          "Suffix": null
        },
        "DBADetails": null,
        "Address": {
          "Address1": "789 Market Street",
          "Address2": "Suite 1200",
          "City": "San Francisco",
          "ProvinceOrState": "CA",
          "ZipCd": "94103",
          "Country": "US"
        },
        "Email": "david.thompson@sample.com",
        "Fax": "2145550199",
        "Phone": "2145550100"
      },
      "AFormData": {
        "AcqDt": "03/04/2025",
        "OutStandingBal": 1508.75,
        "FMV": 5000.99,
        "IsBorrowerLiable": false,
        "PropDesc": "Single 125 Oak Avenue, Austin, CA",
        "AccountNum": "ACC123456789"
      }
    }
  ]
}
Response JSON
ResponseDescriptionAction
200
Success Response - You'll get the below response when the request is processed successfully.
207
Multi-status Response - You'll get the below response when multiple statuses are included.
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
{
  "SubmissionId": "3b7a0e5a-7ad6-4a62-920e-9d1e365ff31f",
  "ScheduleFiling": null,
  "BusinessId": "49c93b22-917f-42eb-b975-c7524cb13410",
  "PayerRef": null,
  "DBARef": null,
  "DBAId": null,
  "Form1099Type": "A",
  "Form1099Records": {
    "SuccessRecords": [
      {
        "SequenceId": "1",
        "RecordId": "d1208b86-f8a8-4498-948c-95d957e9415a",
        "RecipientId": "d9c19b29-ed91-4fe9-bb48-5bdd456ac207",
        "PayeeRef": null,
        "DBARef": null,
        "DBAId": null,
        "AccountNum": "125555",
        "Federal": {
          "Status": "CREATED",
          "StatusCd": "FED_001",
          "StatusTs": "2026-07-24 08:32:19 -04:00",
          "Info": null,
          "Errors": null
        },
        "State": null,
        "Distribution": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "Postal": {
            "PostalType": "USPS_FIRST_CLASS",
            "Status": "CREATED",
            "StatusCd": "POSTAL_001",
            "StatusTs": "2026-07-24 08:32:19 -04:00",
            "Info": "Postal order created"
          },
          "OnlineAccess": {
            "Status": "CREATED",
            "StatusCd": "ONLINE_001",
            "Email": "david.thompson@sample.com",
            "Info": null
          }
        }
      }
    ],
    "ErrorRecords": null
  },
  "Errors": null
}