Version: 2.0.0

Get

Use this endpoint to retrieve a 1099-DIV 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.

GET Form1099DIV/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 returns.
SubmissionManifest	object[]	SubmissionManifest provides brief information about a particular submission on the whole. It contains information like - Submission ID - Tax Year - IsScheduleFiling & ScheduleFiling service details
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission.
TaxYear	string	Tax year for which Form 1099-DIV is filed.
IsFederal	Boolean	Federal Filing will be enabled when the value is True. Form 1099-NEC will be sent directly to the IRS.
IsState	Boolean	State Filing will be enabled when the value is True. Form 1099-NEC 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.
IsDistribution	Boolean	When TRUE, recipient distribution is enabled (postal mail / online access/email).
DistributionDetails	object[]	Distribution configuration. Required when IsDistribution is TRUE.
DistributionType	string	Recipient copy distribution type. Allowed values "POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE"
PostalType	string	Postal service type. Allowed values "USPS_FIRST_CLASS"
IsScheduleFiling	Boolean	Identifies whether the schedule filing service is enabled for the return.
ScheduleFiling	object[]	Contains the preferred date to submit the returns to the IRS/State agencies.
EfileDate	string	Returns the date on which the return is scheduled to be transmitted to the IRS and/or state agencies.
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.
IsDefaultBusiness	Boolean	Identifies whether the business is designated as the default business.
TINDetails	object	Returns the TIN information for the business.
Format	string	Returns the format of the TIN passed.(e.g., PLAIN_TIN, ENCRYPTED_TIN, or TOKENIZED_TIN).
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	First name of the individual.
MiddleNm	string	Middle name of the individual.
LastNm	string	Last name of the individual.
Suffix	string	The suffix of the individual's name.
BusinessNm	string	Legal name of the business.
NameCtrl	string	Name control of the business as registered with the IRS.
DBADetails	object[]	Returns DBA (Doing Business As) information.
DBANm	string	Name of the DBA.
DBARef	string	Your unique identifier for this DBA.
DBAId	Guid	Unique identifier of the DBA generated by TaxBandits.
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.
ProvinceOrState	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	Returns 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.
ProvinceOrState	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 details.
SequenceId	string	An unique reference ID for the submission that can be used to identify a particular record.
RecordId	Guid	An unique identifier generated by TaxBandits when a 1099-DIV return is created.
ReturnManifest	object[]	Returns a high-level summary of the return, including information about the postal service, federal filing, and recipient copy distribution configurations 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	Return postal service type.
IsForced	Boolean	Identifies whether 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.
Recipient	object	Object to identify the recipient details.
RecipientId	Guid	Unique identifier of the recipient generated by TaxBandits.
PayeeRef	string	Your unique identifier for the recipient.
TINDetails	object	Returns the TIN information for the recipient.
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's business.
NameCtrl	string	Name control of the recipient as registered with the IRS.
DBADetails	object	Returns DBA (Doing Business As) information.
DBAId	Guid	Unique identifier of the DBA generated by TaxBandits.
DBANm	string	Name of the DBA.
DBARef	string	Your unique identifier for this 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.
ProvinceOrState	string	DBA's province or state name.
ZipCd	string	DBA's ZIP code.
Country	string	DBA's 2-character country code.
DOB	string	Returns Date of Birth of the recipient.
Address	object	Returns 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.
Email	string	Email address of the recipient.
Fax	string	Fax number of the recipient.
Phone	string	Phone number of the recipient.
DIVFormData	object	Recipient's Form 1099-DIV information.
TotOrdiDiv	number	Box 1a (Total ordinary dividends). Dividends, including dividends from money market funds, net short-term capital gains from mutual funds, and other distributions on stock.
QualiDiv	number	Box 1b (Qualified dividends). The portion of the dividends in box 1a that qualifies for the reduced capital gains rates.
TotCapGain	number	Box 2a (Total capital gain distributions). Total capital gain distributions (long-term), including all amounts shown in boxes 2b, 2c, 2d, and 2f.
UnRecapSecGain	number	Box 2b (Unrecaptured section 1250 gain). Any amount included in box 2a that is an unrecaptured section 1250 gain from certain depreciable real property.
Sec1202Gain	number	Box 2c (Section 1202 gain). Any amount included in box 2a that is a section 1202 gain from certain qualified small business stock.
CollGain	number	Box 2d (Collectibles (28%) gain). Any amount included in box 2a that is a 28% rate gain from sales or exchanges of collectibles.
Sec897OrdiDiv	number	Box 2e (Section 897 ordinary dividends). Any amount included in box 1a that is section 897 gain from dispositions of USRPI.
Sec897CapGain	number	Box 2f (Section 897 capital gain). Any amount included in box 2a that is section 897 gain from dispositions of USRPI.
NonDivDist	number	Box 3 (Nondividend distributions). Nondividend distributions, if determinable.
FedTaxWH	number	Box 4 (Federal income tax withheld). The backup withholding, for the payments reported in box 1, box 2, and box 8 of this form.
Sec199ADiv	number	Box 5 (Section 199A dividends). The qualified REIT dividends paid by a REIT or section 199A dividends paid by a RIC to the recipient.
InvestExp	number	Box 6 (Investment expenses). The recipient's pro rata share of certain amounts deductible by a nonpublicly offered RIC in computing its taxable income.
ForeignTaxPaid	number	Box 7 (Foreign tax paid). Foreign tax paid on dividends and other distributions on stock.
ForeignCountry	string	Box 8 (Foreign country or U.S. possession). The name of the foreign country or U.S. possession for which the foreign tax was paid and reported in box 7.
CashLiquiDist	number	Box 9 (Cash liquidation distributions). Cash distributed as part of a liquidation.
NonCashLiquiDist	number	Box 10 (Noncash liquidation distributions). Noncash distributions made as part of a liquidation, shown at fair market value as of the date of distribution.
IsFATCA	Boolean	FATCA filing requirement checkbox. 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	Box 12 (Exempt-interest dividends). Exempt-interest dividends from a mutual fund or other RIC, including specified private activity bond interest dividends.
PrivActiBondIntDiv	number	Box 13 (Specified private activity bond interest dividends). Exempt-interest dividends paid by a RIC on specified private activity bonds, net of an allocable share of expenses.
Is2ndTINnot	Boolean	2nd TIN notice checkbox. When true, identifies a Payer notified by the IRS twice within 3 calendar years for providing an incorrect TIN who does not want the IRS to send any more notices.
AccountNum	string	Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-DIV is filed.
States	object[]	List of state filing details.
StateCd	string	Box 14 (State). 2-character state code. 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"
StateIdNum	string	Box 15 (State identification no.). Payer's state identification number.Size Range: ..20
StateWH	number	Box 16 (State tax withheld). State income tax withheld. Size Range: 0-9999999999.99
StateIncome	number	State income amount. Size Range: 0-9999999999.99
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	Query Params - Use the SubmissionId alone to get the full submission, or include RecordId to get a specific record.

Sample 1

Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75,519a84f4-5e56-496a-82f3-18f51fdf3d75

Response JSON

Response	Description	Action
200	Success Response - This is a sample response for successful API requests.

Response: 200

{
  "Form1099Records": [
    {
      "SubmissionManifest": {
        "SubmissionId": "d506a6f2-8663-4eb9-a4aa-c33e10e04393",
        "TaxYear": "2026",
        "IsFederal": true,
        "IsState": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "IsScheduleFiling": false,
        "ScheduleFiling": null
      },
      "ReturnHeader": {
        "Business": {
          "BusinessId": "b008346a-c822-441c-b320-b8689a2ce277",
          "PayerRef": null,
          "IsDefaultBusiness": false,
          "IsActive": true,
          "TINDetails": {
            "Format": "PLAIN_TIN",
            "TINType": "EIN",
            "TIN": "72-5564875"
          },
          "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": "(972) 555-0100",
            "PhoneExtn": "205",
            "Email": "horizonllc@sample.com",
            "Fax": "(972) 555-0199"
          },
          "W2Specific": null,
          "Form1042SSpecific": null,
          "ACASpecific": null,
          "Form480Specific": null,
          "BusinessType": null,
          "SigningAuthority": null
        }
      },
      "ReturnData": [
        {
          "SequenceId": "1",
          "RecordId": "a80ac6d3-9a45-4d48-aa2a-078d0ede268f",
          "ReturnManifest": {
            "IsFederal": true,
            "IsState": true,
            "IsDistribution": true,
            "DistributionDetails": {
              "DistributionType": "POSTAL_AND_ONLINE",
              "PostalType": "USPS_FIRST_CLASS"
            },
            "CorrectionDetails": null,
            "IsForced": false
          },
          "Recipient": {
            "RecipientId": "7f62c706-e1db-4884-acf8-783a32f8ac3a",
            "PayeeRef": null,
            "TINDetails": {
              "Format": "PLAIN_TIN",
              "TINType": "SSN",
              "TIN": "321-44-5689"
            },
            "IndividualNm": {
              "FirstNm": "David",
              "MiddleNm": "R",
              "LastNm": "Thompson",
              "Suffix": null
            },
            "NameCtrl": "THOM",
            "BusinessNm": null,
            "DBADetails": null,
            "Address": {
              "Address1": "789 Market Street",
              "Address2": "Suite 1200",
              "City": "San Francisco",
              "ProvinceOrState": "CA",
              "ZipCd": "94103",
              "Country": "US"
            },
            "DOB": null,
            "Email": "david.thompson@sample.com",
            "Fax": "(214) 555-0199",
            "Phone": "(214) 555-0100",
            "W9Details": null,
            "W8BenDetails": null,
            "Form1042SDetails": null
          },
          "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": [
              {
                "StateCd": "CA",
                "StateIdNum": "999-9999-9",
                "StateWH": 17
              }
            ]
          }
        },
        {
          "SequenceId": "2",
          "RecordId": "82661620-d5d3-4ef7-8376-99a29219dde0",
          "ReturnManifest": {
            "IsFederal": true,
            "IsState": true,
            "IsDistribution": false,
            "DistributionDetails": null,
            "CorrectionDetails": null,
            "IsForced": false
          },
          "Recipient": {
            "RecipientId": "f6afebbc-322b-4562-b7b2-d1d844a092a4",
            "PayeeRef": null,
            "TINDetails": {
              "Format": "PLAIN_TIN",
              "TINType": "EIN",
              "TIN": "83-4125678"
            },
            "IndividualNm": null,
            "NameCtrl": "SUMM",
            "BusinessNm": "Summit Consulting Group LLC",
            "DBADetails": null,
            "Address": {
              "Address1": "789 Market Street",
              "Address2": "Suite 1200",
              "City": "San Francisco",
              "ProvinceOrState": "CA",
              "ZipCd": "94103",
              "Country": "US"
            },
            "DOB": null,
            "Email": "accounts@sample.com",
            "Fax": "(512) 555-8399",
            "Phone": "(512) 555-8300",
            "W9Details": null,
            "W8BenDetails": null,
            "Form1042SDetails": null
          },
          "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": [
              {
                "StateCd": "CA",
                "StateIdNum": "999-9999-9",
                "StateWH": 17
              }
            ]
          }
        }
      ]
    }
  ],
  "Errors": null
}

  package main

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

  func main() {
      url := "<APIURL>/v2.0.0/Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75%2C519a84f4-5e56-496a-82f3-18f51fdf3d75"
      method := http.MethodGet

      req, err := http.NewRequest(method, url, nil)
      if err != nil {
          fmt.Println("Error creating request:", err)
          return
      }

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

      client := &http.Client{}

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

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

      fmt.Println("Status:", res.Status)
      fmt.Println("Response:", string(body))
  }

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

  let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75,519a84f4-5e56-496a-82f3-18f51fdf3d75',
  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/Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75,519a84f4-5e56-496a-82f3-18f51fdf3d75", 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/Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75,519a84f4-5e56-496a-82f3-18f51fdf3d75");
  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/Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75,519a84f4-5e56-496a-82f3-18f51fdf3d75")

  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/Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75,519a84f4-5e56-496a-82f3-18f51fdf3d75")
  .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/Form1099DIV/get?submissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&recordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75%2C519a84f4-5e56-496a-82f3-18f51fdf3d75'   --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