Version: 2.0.0

Get

Retrieves the 1099-DIV Correction return information based on the Submission ID given in the request.

GET form1099divcorrection/get

Run in Postman

Request Params

Field	Type	Description
SubmissionId	Guid	An unique identifier generated by TaxBandits when a 1099-DIV return is created. Mention the Form 1099-DIV return's Submission ID that you want to get.
RecordId	Guid[]	An unique identifier generated by TaxBandits when a 1099-DIV return is created. Mention the Form 1099-DIV return's Record ID that you want to get.

Response Body

Field	Type	Description
Form1099Records	object[]	Contains information about Form 1099-DIV correction returns.
SubmissionManifest	object[]	SubmissionManifest provides brief information about a particular submission as a whole.
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission.
TaxYear	string	Tax year of Form 1099 DIV Correction filed.
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Unique identifier of the business generated by TaxBandits.
PayerRef	string	Your unique identifier for the payer.
TINDetails	object	Returns the TIN information for the business
Format	string	Returns the format of the TIN passed.
TINType	string	Returns the TIN type of the business.
TIN	string	Returns the TIN value according to the Format selected.
IndividualNm	object	Returns the individual's name details when the TIN type of the business is "SSN".
FirstNm	string	The first name of the individual.
MiddleNm	string	Middle name of the individual.
LastNm	string	The last name of the individual.
Suffix	string	Suffix of the individual's name.
BusinessNm	string	Legal name of the business. Required when TINType is EIN.
NameCtrl	string	IRS name control of the business.
DBADetails	object[]	DBA (Doing Business As) information.
DBANm	string	Name of the DBA.
DBARef	string	Unique identifier for the DBA.
DBAId	GUID	Unique identifier of the DBA generated by TaxBandits.
IsDefaultDBA	Boolean	Identifies whether the DBA is designated as the default DBA.
Address	object[]	Returns address information of DBA.
Address1	string	Street address or PO Box.
Address2	string	Suite or apartment number.
City	string	DBA's city.
ProvinceOrStateNm	string	DBA's province or state name.
ZipCd	string	DBA's ZIP code.
Country	string	DBA's 2-character country code.
Email	string	Email address of the Business.
Address	object	Primary address of the business.
Address1	string	Street address or PO Box of the business.
Address2	string	Suite or apartment number of the business.
City	string	City of the business.
ProvinceOrStateNm	string	Province or state name of the business.
ZipCd	string	ZIP code of the business.
Country	string	2-character country code of the business.
ContactDetails	object[]	Returns details of the person the IRS can contact regarding this business.
FirstNm	string	First name of the contact person.
MiddleNm	string	Middle name of the contact person.
LastNm	string	Last name of the contact person.
Suffix	string	The suffix of the contact person.
Phone	string	Phone number of the contact person.
PhoneExtn	string	Phone extension number.
Email	string	Email address of the contact person.
Fax	string	Fax number of the contact person.
ReturnData	object[]	Contains information about the recipient details and Form 1099-DIV correction details.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record.
ReturnManifest	object[]	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.
IsFederal	Boolean	Identifies whether Federal filing is enabled for the return.
IsState	Boolean	Identifies whether State filing is enabled for the return.
IsDistribution	Boolean	Identifies whether Recipient distribution is enabled for the return.
DistributionDetails	object[]	Returns recipient distribution configuration details.
DistributionType	string	Recipient copy distribution type.
PostalType	string	Returns postal service type.
CorrectionDetails	Object	Returns information required to identify the correction type for the Form 1099-DIV return.
FederalCorrectionType	String	Returns type of correction for federal filing you are filing for the recipient.
PrevReportedRecordId	Guid	Returns the previously reported Record ID filed with TaxBandits.
OriginalFilingMethod	String	Returns the filing method used to submit the Form 1099-DIV return to the IRS.
IRISUniqueIds	Object	Gets the IRIS unique identifiers associated with the previously filed original return.
UTID	String	Returns the Unique Transmission Identifier (UTID) used to track the original return.
ReceiptId	String	Returns an identifier that confirms IRIS received the transmission.
SubmissionId	String	Returns an identifier that represents a specific submission within a transmission.
RecordId	String	Returns an identifier that represents an Individual return within a submission.
PrevReportedRecipientData	object	Returns recipient information that was submitted in the Original Form 1099-DIV.
RecipientId	Guid	Unique identifier of the recipient generated by TaxBandits.
PayeeRef	string	Your unique identifier for the recipient.
TINDetails	object	Retruns recipient TIN information.
Format	string	Returns the format of the TIN passed.
TINType	string	Returns the TIN type of the recipient.
TIN	string	Returns the TIN value according to the Format selected.
IndividualNm	Object	Returns the individual's name details when the TIN type of the recipient is "SSN".
FirstNm	String	The first name of the individual.
MiddleNm	String	The middle name of the individual.
LastNm	String	The last name of the individual.
Suffix	String	The suffix of the individual's name.
BusinessNm	string	Legal name of the recipient business. Required when TINType is EIN.
NameCtrl	string	IRS name control of the recipient.
CorrectRecipientData	object	Returns corrected Recipient Name and TIN value.
TINDetails	object	Recipient TIN information.
Format	string	Returns the format of the TIN passed.
TINType	string	Returns the TIN type of the recipient.
TIN	string	Returns the TIN value according to the Format selected.
IndividualNm	Object	Returns the individual's name details when the TIN type of the recipient is "SSN".
FirstNm	String	The first name of the individual.
MiddleNm	String	The middle name of the individual.
LastNm	String	The last name of the individual.
Suffix	String	The suffix of the individual's name.
BusinessNm	string	Legal name of the recipient business. Required when TINType is EIN.
NameCtrl	string	IRS name control of the recipient.
Address	Object	Primary address of the recipient.
Address1	String	Street address or PO Box of the recipient.
Address2	String	Suite or apartment number of the recipient.
City	String	City of the recipient.
ProvinceOrState	String	Province or state name of the recipient.
ZipCd	String	ZIP code of the recipient.
Country	String	2-character country code of the recipient.
DIVFormData	object	Form 1099-DIV details for the recipient.
TotOrdiDiv	Number	Gets dividends, including dividends from money market funds, net short-term capital gains from mutual funds, and other distributions on stock.Size Range: 0–9999999999.99
QualiDiv	Number	Gets the portion of the dividends in box 1a that qualifies for the reduced capital gains rates.Size Range: 0–9999999999.99
TotCapGain	Number	Get total capital gain distributions (long-term). Include all amounts shown in boxes 2b, 2c, 2d, and 2f.Size Range: 0–9999999999.99
UnRecapSecGain	Number	Get any amount included in box 2a that is an unrecaptured section 1250 gain from certain depreciable real property.Size Range: 0–9999999999.99
Sec1202Gain	Number	Get any amount included in box 2a that is a section 1202 gain from certain qualified small business stock.Size Range: 0–9999999999.99
CollGain	Number	Get any amount included in box 2a that is a 28% rate gain from sales or exchanges of collectibles.Size Range: 0–9999999999.99
Sec897OrdiDiv	Number	Get any amount included in box 1a that is section 897 gain from dispositions of USRPI.Size Range: 0–9999999999.99
Sec897CapGain	Number	Get any amount included in box 2a that is section 897 gain from dispositions of USRPI.Size Range: 0–9999999999.99
NonDivDist	Number	Get nondividend distributions, if determinable.Size Range: 0–9999999999.99
FedTaxWH	Number	Get the backup withholding, for the payments reported in box1, box 2 and box 8 of this form.Size Range: 0–9999999999.99Note: Box 4 should be less than 40% of box 1a.
Sec199ADiv	Number	Get the qualified REIT dividends paid by a REIT or section 199A dividends paid by a RIC to the recipient.Size Range: 0–9999999999.99
InvestExp	Number	Get the recipient's pro rata share of certain amounts deductible by a nonpublicly offered RIC in computing its taxable income.Size Range: 0–9999999999.99
ForeignTaxPaid	Number	Get foreign tax paid on dividends and other distributions on stock.Size Range: 0–9999999999.99
ForeignCountry	Number	Get the name of the foreign country or U.S. possession for which the foreign tax was paid and reported in box 7.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"
CashLiquiDist	Number	Get cash distributed as part of a liquidation.Size Range: 0–9999999999.99
NonCashLiquiDist	Number	Get noncash distributions made as part of a liquidation. Show the fair market value as of the date of distribution.Size Range: 0–9999999999.99
IsFATCA	Boolean	When true, identifies a U.S. payer reporting on Form(s) 1099 (including reporting payments on this Form 1099-Div) to satisfy their foreign financial asset reporting requirement with respect to a U.S. account.
ExemptIntDiv	Number	Get exempt-interest dividends from a mutual fund or other RIC. Include specified private activity bond interest dividends in box 12 and in the total for box 11.Size Range: 0-9999999999.99
PrivActiBondIntDiv	Number	Get exempt-interest dividends paid by a RIC on specified private activity bonds to the extent that the dividends are attributable to interest on the bonds received by the RIC minus an allocable share of the expenses.Size Range: 0–9999999999.99
Is2ndTINnot	Boolean	When 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.
AccountNum	String	Optional Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-DIV is filed.Size Range: 4..20Note: If the account number on the return you file is the same as any previously filed return, TaxBandits will append 3 random numbers at the end of the account number.
States	object[]	List of state filing details.
StateCorrectionType	String	Type of state correction you are filing.
StateCd	string	2-character state code.
StateIdNum	string	Payer's state identification number.
StateWH	number	State income tax withheld.
StateIncome	number	State income amount.
Errors	object[]	Shows detailed error information.
Id	string	Returns the validation error Id.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request Params

Sample	Description	Action
Sample 1	Get with only the SubmissionID
Sample 2	Get with only the RecordID

Sample 1

Form1099DIVCorrection/Get?SubmissionId=9cac4124-4820-4101-9281-841ba8cced0e

Response JSON

Response	Description	Action
200	Success Response - This is a sample response for successful API requests.
400	Bad Request Response - This is a sample response when the request contains invalid or missing query parameters.
401	Unauthorized Response - This is a sample response when the access token is missing, expired, or invalid.

Response: 200

{
  "Form1099Records": [
    {
      "SubmissionManifest": {
        "SubmissionId": "7bd46527-75f1-4ddd-88a1-1cbc951912d5",
        "TaxYear": "2026",
        "IsScheduleFiling": false,
        "ScheduleFiling": null,
        "IsFederal": true,
        "IsState": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_ONLY",
          "PostalType": "USPS_FIRST_CLASS"
        }
      },
      "ReturnHeader": {
        "Business": {
          "BusinessId": "229429ba-da91-4e6f-96e9-0932849d6025",
          "PayerRef": "Snow123",
          "IsDefaultBusiness": false,
          "IsActive": true,
          "TINDetails": {
            "Format": "PLAIN_TIN",
            "TINType": "EIN",
            "TIN": "72-4234200"
          },
          "IndividualNm": null,
          "BusinessNm": "Snowdaze LLC",
          "NameCtrl": "SNOW",
          "DBADetails": {
            "DBANm": "Iceberg Icecreams",
            "DBARef": "4fff27c0-fb7c-4eb7-b1d7-da767c92bca9",
            "DBAId": "41f31009-e02e-4122-8c58-9c13b4f16a59",
            "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"
          },
          "ContactDetails": {
            "FirstNm": "James",
            "MiddleNm": "A",
            "LastNm": "Anderson",
            "Suffix": "Jr",
            "Phone": "(803) 555-1234",
            "PhoneExtn": "101",
            "Email": "contact@snowdaze.com",
            "Fax": "(803) 555-5678"
          },
          "W2Specific": null,
          "Form1042SSpecific": null,
          "ACASpecific": null,
          "Form480Specific": null,
          "BusinessType": null,
          "SigningAuthority": null
        }
      },
      "ReturnData": [
        {
          "SequenceId": "1",
          "RecordId": "4c6a371c-49fa-49de-9c8f-8fd1db2856a0",
          "ReturnManifest": {
            "IsFederal": true,
            "IsState": true,
            "IsDistribution": true,
            "DistributionDetails": {
              "DistributionType": "POSTAL_ONLY",
              "PostalType": "USPS_FIRST_CLASS"
            },
            "CorrectionDetails": {
              "FederalCorrectionType": "RECIPIENT_AMOUNT",
              "PrevReportedRecordId": "",
              "OriginalFilingMethod": "IRIS",
              "IRISUniqueIds": {
                "UTID": "37f44812-b4ed-4255-aba2-afc13a56493a:IRIS:DB7RM::A",
                "ReceiptId": "2024-65384464963-c12b927aa",
                "SubmissionId": "66522383",
                "RecordId": "98517992"
              }
            },
            "IsForced": false
          },
          "PrevReportedRecipientData": {
            "RecipientId": "af955c5f-9819-44fb-8695-7a6ba0353f53",
            "PayeeRef": null,
            "TINDetails": {
              "Format": "PLAIN_TIN",
              "TINType": "SSN",
              "TIN": "587-41-6432"
            },
            "IndividualNm": {
              "FirstNm": "Olivia",
              "MiddleNm": "M",
              "LastNm": "Harris",
              "Suffix": null
            },
            "NameCtrl": "HARR",
            "BusinessNm": null
          },
          "CorrectRecipientData": {
            "TINDetails": {
              "Format": "PLAIN_TIN",
              "TINType": "SSN",
              "TIN": "345-41-7655"
            },
            "IndividualNm": {
              "FirstNm": "Walter",
              "MiddleNm": "M",
              "LastNm": "holland",
              "Suffix": null
            },
            "NameCtrl": "HARR",
            "BusinessNm": null,
            "Address": {
              "Address1": "780 Main Street",
              "Address2": "Unit 12",
              "City": "Charleston",
              "ProvinceOrState": "WV",
              "ZipCd": "25301",
              "Country": "US"
            }
          },
          "DIVFormData": {
            "TotOrdiDiv": 4998,
            "QualiDiv": 200,
            "TotCapGain": 2227,
            "UnRecapSecGain": 41.5,
            "Sec1202Gain": 42.6,
            "CollGain": 48.55,
            "Sec897OrdiDiv": 50.55,
            "Sec897CapGain": 3.55,
            "NonDivDist": 43.55,
            "FedTaxWH": 44.55,
            "Sec199ADiv": 45.55,
            "InvestExp": 46.55,
            "ForeignTaxPaid": 70.55,
            "ForeignCountry": "CA",
            "CashLiquiDist": 80.55,
            "NonCashLiquiDist": 90.55,
            "IsFATCA": false,
            "ExemptIntDiv": 40748.55,
            "PrivActiBondIntDiv": 23740.5,
            "Is2ndTINnot": false,
            "AccountNum": "20123130000009000001",
            "States": [
              {
                "StateCorrectionType": "NEW",
                "StateCd": "CA",
                "StateIdNum": "Z9999999",
                "StateWH": 14.55
              }
            ]
          }
        }
      ]
    }
  ],
  "Errors": null
}

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  url := "<APIURL>/v2.0.0/Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b"
  method := "GET"

  // GET request does not require a request body
  req, err := http.NewRequest(method, url, nil)
  if err != nil {
    fmt.Println(err)
    return
  }

  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "<ACCESS_TOKEN>")

  client := &http.Client{}

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }

  fmt.Println(string(body))
}

const axios = require('axios');
let data = '';

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': '<ACCESS_TOKEN>'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

import http.client
import json

conn = http.client.HTTPSConnection("<APIURL>")
payload = ''
headers = {
  'Content-Type': 'application/json',
  'Authorization': '<ACCESS_TOKEN>'
}
conn.request("GET", "/v2.0.0/Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "<APIURL>/v2.0.0/Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b");
request.Headers.Add("Authorization", "<ACCESS_TOKEN>");
var content = new StringContent("", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

require "uri"
require "json"
require "net/http"

url = URI("<APIURL>/v2.0.0/Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "<ACCESS_TOKEN>"

response = http.request(request)
puts response.read_body

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("<APIURL>/v2.0.0/Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b")
  .method("GET", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "<ACCESS_TOKEN>")
  .build();
Response response = client.newCall(request).execute();

curl --location '<APIURL>/v2.0.0/Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b' --header 'Content-Type: application/json' --header 'Authorization: <ACCESS_TOKEN>' --data ''

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Get

Get

Request Params

Response Body

Sample 1

Response: 200