Skip to main content
Version: 2.0.0

Get

Get

GET form1099kcorrection/get 

Request Body

FieldTypeDescription
SubmissionIdGuidAn unique identifier generated by TaxBandits when a 1099-K correction is created. Mention the Form 1099-K correction Submission ID that you want to get.
RecordIdsGuid[]An unique identifier generated by TaxBandits when a 1099-K correction is created. Mention the Form 1099-K correction Record ID that you want to get.

Response Body

FieldTypeDescription
Form1099Recordsobject[]Contains information about Form 1099-K correction returns.
SubmissionManifestobject[]SubmissionManifest provides brief information about a particular submission as a whole.
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
TaxYearstringTax year of Form 1099 K Correction filed.
ReturnHeaderobjectContains information about the Business details.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidUnique identifier of the business generated by TaxBandits.
PayerRefstringYour unique identifier for the payer.
TINDetailsobjectReturns the TIN information for the business
FormatstringReturns the format of the TIN passed
TINTypestringReturns the TIN type of the business.
TINstringReturns the TIN value according to the Format selected.
IndividualNmobjectReturns the individual's name details when the TIN type of the business is "SSN".
FirstNmstringThe first name of the individual.
MiddleNmstringMiddle name of the individual.
LastNmstringThe last name of the individual.
SuffixstringSuffix of the individual’s name.
BusinessNmstringLegal name of the business. Required when TINType is EIN.
NameCtrlstringIRS name control of the business.
DBADetailsobject[]DBA (Doing Business As) information.
DBANmstringName of the DBA.
DBARefstringUnique identifier for the DBA.
DBAIdGUIDUnique identifier of the DBA generated by TaxBandits.
IsDefaultDBABooleanIdentifies whether the DBA is designated as the default DBA
Addressobject[]Returns address information of DBA
Address1stringStreet address or PO Box.
Address2stringSuite or apartment number.
CitystringDBA’s city.
ProvinceOrStateNmstringDBA's province or state name.
ZipcdDBA’s ZIP code.
CountrystringDBA’s 2-character country code.
EmailstringEmail address of the Business
AddressobjectPrimary address of the business
Address1stringStreet address or PO Box of the business.
Address2stringSuite or apartment number of the business.
CitystringCity of the business.
ProvinceOrStateNmstringProvince or state name of the business.
ZipCdstringZIP code of the business.
Countrystring2-character country code of the business.
ContactDetailsobject[]Returns details of the person the IRS can contact regarding this business.
FirstNmstringFirst name of the contact person.
MiddleNmstringMiddle name of the contact person.
LastNmstringLast name of the contact person.
SuffixstringThe suffix of the contact person.
PhonestringPhone number of the contact person
PhoneExtnstringPhone extension number.
EmailstringEmail address of the contact person.
FaxstringFax number of the contact person.
ReturnDataobject[]Contains information about the recipient details and Form 1099 K correction details.
SequenceIdstringA unique reference ID for the submission that can be used to identify a particular record.
ReturnManifestobject[]Returns a high-level summary of a return, including information about the postal service, federal filing, state filing, and recipient copy distribution configurations and correction details associated with the return.
IsFederalBooleanIdentifies whether Federal filling is enabled for the return
IsStateBooleanIdentifies whether State filling is enabled for the return
IsDistributionBooleanIdentifies whether Recipeint distribution is enabled for the return
DistributionDetailsobject[]Returns recipient distribution configuration details
DistributionTypestringRecipient copy distribution type.
PostalTypestringReturns postal service type.
CorrectionDetailsObjectReturns information required to identify the correction type for the Form 1099-K return
FederalCorrectionTypeStringReturns type of correction for federal filing you are filing for the recipient.
PrevReportedRecordIdGuidReturns the previously reported Record ID filed with TaxBandits.
OriginalFilingMethodStringReturns the filing method used to submit the Form 1099-K return to the IRS
IRISUniqueIdsObjectGets the IRIS unique identifiers associated with the previously filed original return.
UTIDStringReturns the Unique Transmission Identifier (UTID) used to track the original return
ReceiptIdStringReturns an identifier that confirms IRIS received the transmission.
SubmissionIdStringReturns an identifier that represents a specific submission within a transmission.
RecordIdStringReturns an identifier that represents an Individual return within a submission.
PrevReportedRecipientDataobjectReturns recipient information that was submitted in the Original Form 1099-K.
RecipientIdGuidUnique identifier of the recipient generated by TaxBandits.
PayeeRefstringYour unique identifier for the recipient.
TINDetailsobjectRetruns recipient TIN information.
FormatstringReturns the format of the TIN passed
TINTypestringReturns the TIN type of the recipient.
TINstringReturns the TIN value according to the Format selected.
IndividualNmObjectReturns the individual's name details when the TIN type of the recipient is "SSN".
FirstNmStringThe first name of the individual.
MiddleNmStringThe middle name of the individual.
LastNmStringThe last name of the individual.
SuffixStringThe suffix of the individual’s name.
BusinessNmstringLegal name of the recipient business. Required when TINType is EIN.
NameCtrlstringIRS name control of the recipient.
CorrectRecipientDataobjectReturns corrected Recipient Name and TIN value.
TINDetailsobjectRecipient TIN information.
FormatstringReturns the format of the TIN passed
TINTypestringReturns the TIN type of the recipient.
TINstringReturns the TIN value according to the Format selected.
IndividualNmObjectReturns the individual's name details when the TIN type of the recipient is "SSN".
FirstNmStringThe first name of the individual.
MiddleNmStringThe middle name of the individual.
LastNmStringThe last name of the individual.
SuffixStringThe suffix of the individual’s name.
BusinessNmstringLegal name of the recipient business. Required when TINType is EIN.
NameCtrlstringIRS name control of the recipient.
AddressObjectPrimary address of the recipient.
Address1StringStreet address or PO Box of the recipient.
Address2StringSuite or apartment number of the recipient.
CityStringCity of the recipient.
ProvinceOrStateStringProvince or state name of the recipient.
ZipCdStringZIP code of the recipient.
CountryString2-character country code of the recipient.
KFormDataobjectForm 1099-K details for the recipient.
GrossAmtnumberGross amount of the total reportable payment card/third-party network transactions for the calendar year.
CardNotPresentTxnsnumberGross amount of the total reportable payment card/third-party network transactions for the calendar year where the card was not present at the time of the transaction or the card number was keyed into the terminal.
CashTipsnumberCash tips are paid to the recipient.
TTOC1stringTreasury Tipped Occupation code 1.
TTOC2stringTreasury Tipped Occupation code 2.
NumPymtTxnsnumberNumber of payment transactions processed through the payment card/ third party payer network.
FedTaxWHnumberBackup withholding.
JannumberGross amount of the total reportable payment transactions for January.
FebnumberGross amount of the total reportable payment transactions for February.
MarnumberGross amount of the total reportable payment transactions for March.
AprnumberGross amount of the total reportable payment transactions for April.
MaynumberGross amount of the total reportable payment transactions for May.
JunnumberGross amount of the total reportable payment transactions for June.
JulnumberGross amount of the total reportable payment transactions for July.
AugnumberGross amount of the total reportable payment transactions for August.
SepnumberGross amount of the total reportable payment transactions for September.
OctnumberGross amount of the total reportable payment transactions for October.
NovnumberGross amount of the total reportable payment transactions for November.
DecnumberGross amount of the total reportable payment transactions for December.
MerchantCdstringMerchant category code.
AccountNumstringAccount number of Payer having multiple accounts for a recipient for whom more than one Form 1099-K is filed.
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.
FilerIndicatorstringEnter the type of Filer Indicator.
IndicateTxnsReportedstringType of transactions reported.
PSEDetailsobjectPSE Details of Recipient
PSENamestringPSE Name
PSEPhonestringPSE Phone.
Statesobject[]List of state filing details.
StateCorrectionTypeStringType of state correction you are filing.
StateCdstring2-character state code.
StateIdNumstringPayer’s state identification number.
StateWHnumberState income tax withheld.
StateIncomenumberState income amount.
Errorsobject[]Shows detailed error information
IdstringReturns the validation error Id
NamestringName of the validation error
MessagestringDescription of the validation error
Request JSON
SampleDescriptionAction
Sample 1
Get with SubmissionId and RecordIds
Sample 1
Form1099kCorrection/get?SubmissionId=f561a414-c92f-4026-9c29-71cd1979bf72&RecordIds=71cd1979bf72-f561a414-c92f-4026-9c29
Response JSON
ResponseDescriptionAction
200
Success Response - This is a sample response for successful API requests.
Response: 200
{
"Form1099Records": {
"SubmissionManifest": {
"SubmissionId": "c672df52-6d1e-45ba-8631-aff8339d7fa3",
"TaxYear": "2026"
},
"ReturnHeader": {
"Business": {
"BusinessId": null,
"PayerRef": "Snow123",
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "12-0239751"
},
"IndividualNm": null,
"BusinessNm": "Horizon LLC",
"NameCtrl": "HORI",
"DBADetails": null,
"Email": "horizonllc@sample.com",
"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": "michael.carter@sample.com",
"Fax": "9725550199"
}
}
},
"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": "David",
"MiddleNm": "R",
"LastNm": "Thompson",
"Suffix": "Jr"
}
},
"CorrectRecipientData": {
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "SSN",
"TIN": "597-85-6598"
},
"IndividualNm": {
"FirstNm": "Davidson",
"MiddleNm": "R",
"LastNm": "Thompson",
"Suffix": "Jr"
},
"BusinessNm": null,
"NameCtrl": null,
"DBADetails": null,
"Address": {
"Address1": "1450 Oak Lawn Avenue",
"Address2": "Apt 310",
"City": "Dallas",
"ProvinceOrState": "TX",
"ZipCd": "75207",
"Country": "US"
},
"Email": "david.thompson@example.com",
"Fax": "9725550199",
"Phone": "9725550100"
},
"KFormData": {
"GrossAmt": 1200,
"CardNotPresentTxns": 500,
"CashTips": 500,
"TTOC1": "102",
"TTOC2": "103",
"MerchantCd": "0742",
"NumPymtTxns": 12,
"FedTaxWH": 55,
"Jan": 100,
"Feb": 100,
"Mar": 100,
"Apr": 100,
"May": 100,
"Jun": 100,
"Jul": 100,
"Aug": 100,
"Sep": 100,
"Oct": 100,
"Nov": 100,
"Dec": 100,
"AccountNum": "12345",
"Is2ndTINnot": true,
"FilerIndicator": "EPF",
"PSEDetails": {
"PSEName": "Dairy Delights LLC",
"PSEPhone": "9634567890"
},
"IndicateTxnsReported": "payment_card",
"States": [
{
"StateCorrectionType": "NEW",
"StateCd": "CA",
"StateIdNum": "Z9999999",
"StateWH": 14.55,
"StateIncome": 765
}
]
}
}
]
},
"Errors": null
}