Skip to main content
Version: 2.0

Get

Get

Use this endpoint to retrieve a 1099-INT submission and its records. Provide the SubmissionId to retrieve the whole submission, optionally narrowing to a specific RecordId.

The response includes the full payer, recipient, and form data as originally submitted — useful for audit trails and displaying return details in your application.

POST form1099int/get 

Request Params

FieldTypeDescription
SubmissionIdGuidAn unique identifier generated by TaxBandits when a 1099-INT return is created. Mention the Form 1099-INT return's Submission ID that you want to get.
RecordIdGuid[]An unique identifier generated by TaxBandits when a 1099-INT return is created. Mention the Form 1099-INT return's Record ID that you want to get.

Response Body

FieldTypeDescription
Form1099INTRecordsobject[]Contains information about Form W2-G returns.
SubmissionManifestobject[]SubmissionManifest provides brief information about a particular submission on the whole.

It contains information like

  • Submission ID
  • Tax Year
  • IsScheduleFiling & ScheduleFiling service details
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
TaxYearstringTax year of Form W2-G to be filed.
Allowed values

Allowed values: "2025", "2026"

IsScheduleFilingBooleanWhen true, schedule filing services will be provided for Form W2-G returns under this submission.
ScheduleFilingobject[]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.

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

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

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

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

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
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 W2-G 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
RecordIdGuidUnique Identifier of the Record. Mention the Form W2-G return's Record ID that you want to update. If you do not provide the Record ID, then a new record will be added to the submission.
ReturnManifestobject[]Filing options for this record.
IsFederalBooleanFederal Filing for the return will be enabled when the value is True. Form W2-G will be sent directly to the IRS.
IsStateBooleanState Filing for the return will be enabled when the value is True. Form W2-G 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".

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

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

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

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

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
INTFormDataobjectRecipient's Form 1099-INT information.
PayerRTNnumberGets the routing and transit number (RTN), WHO wishes to participate in the program for direct deposit of refunds. It is Optional.

Size Range: 9
IntIncomenumberGets the taxable interest amounts of $10 or more which is not included in box 3 (Interest on U.S. Savings Bonds and Treas. Obligations).

Size Range: 0-9999999999.99
EarlyWithdrawPenaltynumberGet the interest or principal forfeited because of an early withdrawal of time deposits.

Size Range: 0-9999999999.99
IntOnUSBondsnumberGet the interest on U.S. Savings Bonds, Treasury bills, Treasury notes, and Treasury bonds.

Size Range: 0-9999999999.99
FedTaxWHnumberGet the backup withholding, for the payments reported in box 1, box 2 and box 8 of this form.

Size Range: 0-9999999999.99

Note: This value should be less than 40% of the sum of boxes 1, 3, 8.
InvestExpnumberGet the Investment Expenses.

Size Range: 0-9999999999.99
ForeignTaxPaidnumberGet any foreign tax paid on interest. The amount should be in U.S. dollars.

Size Range: 0-9999999999.99
ForeignCountrystringGet the name of the foreign country or U.S. possession for which the foreign tax was paid and reported in box 6.

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"

TaxExemptIntnumberGet the tax-exempt interest.

Size Range: 0-9999999999.99
BondIntnumberGet the interest of $10 or more from specified private activity bonds.

Size Range: 0-9999999999.99
MarketDiscnumberGet the amount of market discount that accrued on the debt instrument during the tax year in the amount of $10 or more.

Size Range: 0-9999999999.99
BondPrenumberGet the amount of bond premium amortization allocable to the interest paid during the tax year for a taxable covered security acquired at a premium.

Size Range: 0-9999999999.99
BondPreOnTreasOblignumberGet the amount of bond premium amortization allocable to the interest paid during the tax year for a U.S. Treasury obligation that is a covered security.

Size Range: 0-9999999999.99
BondPreOnTaxExemptnumberGet the amount of bond premium amortization allocable to the interest paid during the tax year for a tax-exempt covered security acquired at a premium.

Size Range: 0-9999999999.99
USIPstringFor single bonds or accounts containing a single bond, get the CUSIP number of the tax-exempt bond for which tax-exempt interest is reported in box 8 or tax credit bond.

Size Range: 13
IsFATCAbooleanWhen true, identifies a U.S. payer reporting on Form(s) 1099 (including reporting payments on this Form 1099-INT) to satisfy their foreign financial asset reporting requirement with respect to a U.S. account.
AccountNumstringAccount number of Payer having multiple accounts for a recipient for whom more than one Form 1099-INT is filed. Optional. Account number assigned by the payer to distinguish the recipient's account.

Size Range: 1–20 (or 4..20)

Note: If the account number on the return you file is the same as any previously filed return, TaxBandits will append 3 random numbers at the end of the account number.
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 []Optional. State filing line-item data for the recipient. Required when ReturnManifest.IsState is TRUE.
StateCdstringTwo-letter state code where the income was earned, or the state filing applies.

Size Range: 2
StateWHnumberOptional. State tax withheld.

Size Range: 0–9999999999.99
StateIdNumstringOptional. Payer's state identification number.

Size Range: 1–20
StateIncomenumberOptional. State income.

Size Range: 0–9999999999.99
Request Params
"Form1099INT/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75,519a84f4-5e56-496a-82f3-18f51fdf3d75"
Response Json
ResponseDescriptionAction
200
Success Response - This is a sample response for successful API requests.
Response: 200
{
"Form1099INTRecords": [
{
"SubmissionManifest": {
"TaxYear": "2026",
"IsScheduleFiling": false,
"ScheduleFiling": {
"EfileDate": null
}
},
"ReturnHeader": {
"Business": {
"PayerRef": "PAYER001",
"BusinessId": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "12-3456722"
},
"IndividualNm": {
"FirstNm": "Robert",
"MiddleNm": "M",
"LastNm": "Johnson",
"Suffix": null
},
"BusinessNm": "Summit Holdings Inc.",
"NameCtrl": "SUMM",
"DBADetails": {
"DBANm": "Peak Consulting Group",
"DBARef": "DBA2024",
"DBAId": null,
"IsDefaultDBA": true,
"Address": {
"Address1": "4500 Corporate Drive",
"Address2": "Building B, Suite 200",
"City": "Charlotte",
"ProvinceOrState": "NC",
"ZipCd": "28217",
"Country": "US"
}
},
"Email": "robert.johnson@summit.com",
"Address": {
"Address1": "4500 Corporate Drive",
"Address2": "Building B, Suite 200",
"City": "Charlotte",
"ProvinceOrState": "NC",
"ZipCd": "28217",
"Country": "US"
},
"ContactDetails": {
"FirstNm": "Robert",
"MiddleNm": "M",
"LastNm": "Johnson",
"Suffix": null,
"Phone": "7045558901",
"PhoneExtn": null,
"Email": "contact@summitholdings.com",
"Fax": null
}
}
},
"ReturnData": [
{
"SequenceId": "1",
"ReturnManifest": {
"IsFederal": true,
"IsState": true,
"IsDistribution": true,
"DistributionDetails": {
"DistributionType": "POSTAL_AND_ONLINE",
"PostalType": "USPS_FIRST_CLASS"
},
"IsForced": false
},
"Recipient": {
"RecipientId": null,
"PayeeRef": "PAYEE01",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "SSN",
"TIN": "737-65-4340"
},
"NameCtrl": "MEGA",
"IndividualNm": {
"FirstNm": "Sarah",
"MiddleNm": "E",
"LastNm": "Williams",
"Suffix": null
},
"BusinessNm": null,
"DBADetails": {
"DBAId": null,
"DBANm": "Mega Enterprise",
"DBARef": "DBA2025",
"Address": {
"Address1": "789 Business Park Blvd",
"Address2": "Floor 12, Suite 1200",
"City": "Austin",
"ProvinceOrState": "TX",
"ZipCd": "78759",
"Country": "US"
}
},
"DOB": "01/02/1990",
"Address": {
"Address1": "789 Business Park Blvd",
"Address2": "Floor 12, Suite 1200",
"City": "Austin",
"ProvinceOrState": "TX",
"ZipCd": "78759",
"Country": "US"
},
"Email": "sarah.williams@megacorp.com",
"Fax": null,
"Phone": "5125551234"
},
"INTFormData": {
"PayerRTN": 106546867,
"IntIncome": 901,
"EarlyWithdrawPenalty": 78,
"InterestOnUS": 98,
"FedIncomeTaxWH": 56,
"InvestExp": 89,
"ForeignTaxPaid": 77,
"ForeignCountry": "CA",
"TaxExemptInterest": 99,
"BondInterest": 22,
"MarketDiscount": 999,
"BondPre": 9999,
"BondPreOnTreasOblig": 877,
"BondPreOnTaxExempt": 9999,
"USIPno": "87JJ767",
"IsFATCA": true,
"Is2ndTINnot": true,
"AccountNum": "1121234",
"States": [
{
"StateCd": "AZ",
"StateIdNum": "99-9999999",
"StateWH": 17
},
{
"StateCd": "CA",
"StateIdNum": "999999992",
"StateWH": 17
}
]
}
}
]
}
],
"Errors": null
}