Version: 2.0.0

Get

Use this endpoint to retrieve a 1099-A 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 Form1099A/Get

Run in Postman

Request Params

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

Response Body

Field	Type	Description
Form1099Records	object[]	Contains the retrieved Form 1099-A return records matching the requested SubmissionId and RecordIds.
SubmissionManifest	object[]	Returns brief information about the submission. Includes details such as Submission ID, Tax Year, IsScheduleFiling, and ScheduleFiling service details.
SubmissionId	Guid	Unique identifier generated by TaxBandits for the retrieved Form 1099-A submission.
TaxYear	string	Returns the tax year for which the Form 1099-A Acquisition or Abandonment of Secured Property return was filed.
IsFederal	Boolean	Federal Filing will be enabled when the value is True. Form 1099-A will be sent directly to the IRS.
IsState	Boolean	State 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.
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 retrieved Form 1099-A return.
ScheduleFiling	object[]	Returns the preferred date on which the Form 1099-A return is scheduled to be submitted to the IRS.
EfileDate	string	Returns the date on which the Form 1099-A return is scheduled to be transmitted to the IRS.
ReturnHeader	object	Returns information about the lender (payer) business details associated with the Form 1099-A return.
Business	object	Returns the business details of the lender (payer) who filed the Form 1099-A.
BusinessId	Guid	Returns the unique identifier generated by TaxBandits for the lender (payer) business.
PayerRef	string	Returns your unique identifier for the lender (payer), as provided during the filing of Form 1099-A.
IsDefaultBusiness	Boolean	Identifies whether the lender business is designated as the default business in TaxBandits.
TINDetails	object	Returns the TIN information for the lender (payer) business.
Format	string	Returns the format in which the TIN was provided (e.g., PLAIN_TIN, ENCRYPTED_TIN, or TOKENIZED_TIN).
TINType	string	Returns the TIN type of the lender (payer) business (e.g., EIN, SSN, QI-EIN, ITIN).
TIN	string	Returns the TIN value of the lender (payer) business according to the Format returned.
IndividualNm	object	Returns the individual's name details when the TIN type of the lender business is SSN.
FirstNm	string	Returns the first name of the individual.
MiddleNm	string	Returns the middle name of the individual.
LastNm	string	Returns the last name of the individual.
Suffix	string	Returns the suffix of the individual's name.
BusinessNm	string	Returns the legal name of the lender (payer) business.
NameCtrl	string	Returns the IRS name control of the lender (payer) business.
DBADetails	object[]	Returns DBA (Doing Business As) information for the lender (payer) business.
DBANm	string	Returns the name of the DBA.
DBARef	string	Returns your unique identifier for this DBA.
DBAId	Guid	Returns the unique identifier generated by TaxBandits for the DBA.
Address	object[]	Returns the address information of the DBA.
Address1	string	Returns the street address or PO Box of the DBA.
Address2	string	Returns the suite or apartment number of the DBA.
City	string	Returns the city of the DBA.
ProvinceOrState	string	Returns the province or state name of the DBA.
Zipcd	string	Returns the ZIP code of the DBA.
Country	string	Returns the 2-character country code of the DBA.
Email	string	Returns the email address of the lender (payer) business.
Address	object	Returns the primary address of the lender (payer) business.
Address1	string	Returns the street address or PO Box of the lender business.
Address2	string	Returns the suite or apartment number of the lender business.
City	string	Returns the city of the lender business.
ProvinceOrState	string	Returns the province or state name of the lender business.
ZipCd	string	Returns the ZIP code of the lender business.
Country	string	Returns the 2-character country code of the lender business.
ContactDetails	object[]	Returns the details of the contact person the IRS can reach regarding the lender business.
FirstNm	string	Returns the first name of the contact person.
MiddleNm	string	Returns the middle name of the contact person.
LastNm	string	Returns the last name of the contact person.
Suffix	string	Returns the suffix of the contact person's name.
Phone	string	Returns the phone number of the contact person.
PhoneExtn	string	Returns the phone extension number of the contact person.
Email	string	Returns the email address of the contact person.
Fax	string	Returns the fax number of the contact person.
ReturnData	object[]	Returns the recipient (borrower) details and Form 1099-A data for the retrieved return.
SequenceId	string	Returns the unique reference ID provided during filing that identifies this particular Form 1099-A record.
RecordId	Guid	Returns the unique identifier generated by TaxBandits for this Form 1099-A return record.
ReturnManifest	object[]	Returns a high-level summary of the Form 1099-A return, including federal filing, state filing, and recipient copy distribution configuration details.
IsFederal	Boolean	Identifies whether federal filing is enabled for the retrieved Form 1099-A return.
IsDistribution	Boolean	Identifies whether recipient copy distribution is enabled for the retrieved Form 1099-A return.
DistributionDetails	object[]	Returns the recipient copy distribution configuration details for the Form 1099-A return.
DistributionType	string	Returns the recipient copy distribution type (e.g., POSTAL_ONLY, ONLINE_ACCESS, POSTAL_AND_ONLINE).
PostalType	string	Returns the postal service type used for distributing the Form 1099-A recipient copy.
IsForced	Boolean	Identifies whether duplicate verification was bypassed and a new Form 1099-A return was created for the recipient regardless of previously filed returns with the same amounts.
Recipient	object	Returns the recipient (borrower) details for the Form 1099-A return.
RecipientId	Guid	Returns the unique identifier generated by TaxBandits for the borrower (recipient).
PayeeRef	string	Returns your unique identifier for the borrower (recipient), as provided during the filing of Form 1099-A.
TINDetails	object	Returns the TIN information for the borrower (recipient).
Format	string	Returns the format in which the recipient's TIN was provided (e.g., PLAIN_TIN, ENCRYPTED, or TOKEN).
TINType	string	Returns the TIN type of the borrower (recipient) (e.g., EIN, SSN, ITIN).
TIN	string	Returns the TIN value of the borrower (recipient) according to the Format returned.
IndividualNm	object	Returns the individual's name details when the TIN type of the borrower (recipient) is SSN, ITIN, or ATIN.
FirstNm	string	Returns the first name of the borrower (recipient).
MiddleNm	string	Returns the middle name of the borrower (recipient).
LastNm	string	Returns the last name of the borrower (recipient).
Suffix	string	Returns the suffix of the borrower (recipient) individual's name.
BusinessNm	string	Returns the legal name of the borrower (recipient) business.
NameCtrl	string	Returns the IRS name control of the borrower (recipient).
DBADetails	object	Returns DBA (Doing Business As) information for the borrower (recipient).
DBAId	Guid	Returns the unique identifier generated by TaxBandits for the recipient's DBA.
DBANm	string	Returns the name of the recipient's DBA.
DBARef	string	Returns your unique identifier for the recipient's DBA.
Address	object	Returns the address information of the recipient's DBA.
Address1	string	Returns the street address or PO Box of the recipient's DBA.
Address2	string	Returns the suite or apartment number of the recipient's DBA.
City	string	Returns the city of the recipient's DBA.
ProvinceOrState	string	Returns the province or state name of the recipient's DBA.
ZipCd	string	Returns the ZIP code of the recipient's DBA.
Country	string	Returns the 2-character country code of the recipient's DBA.
DOB	string	Returns the date of birth of the borrower (recipient).
Address	object	Returns the primary address of the borrower (recipient).
Address1	string	Returns the street address or PO Box of the borrower (recipient).
Address2	string	Returns the suite or apartment number of the borrower (recipient).
City	string	Returns the city of the borrower (recipient).
ProvinceOrState	string	Returns the province or state name of the borrower (recipient).
ZipCd	string	Returns the ZIP code of the borrower (recipient).
Country	string	Returns the 2-character country code of the borrower (recipient).
Email	string	Returns the email address of the borrower (recipient).
Fax	string	Returns the fax number of the borrower (recipient).
Phone	string	Returns the phone number of the borrower (recipient).
AFormData	object	Returns the Form 1099-A Acquisition or Abandonment of Secured Property data for the retrieved return.
AcqDt	string	Returns the date of the lender's acquisition of the secured property, or the date the lender first knew of the abandonment (Box 1), in the format MM/DD/YYYY or MM-DD-YYYY.
BalOutStanding	string	Returns the balance of the principal outstanding on the loan at the time of the acquisition or abandonment as reported in Box 2. Size Range: 0-9999999999.99
FMV	string	Returns the fair market value of the secured property at the time of acquisition or abandonment as reported in Box 4. Size Range: 0-9999999999.99
IsBorrowerLiable	Boolean	Returns whether the borrower was personally liable for repayment of the debt as reported in Box 5. When True, the borrower was personally liable for debt repayment.
PropDesc	Boolean	Returns the description of the secured property that was acquired or abandoned as reported in Box 6. Size Range: 39
AccountNum	string	Returns the account number assigned to the borrower (recipient) by the lender. Populated when more than one Form 1099-A was filed for the same borrower (recipient).
Errors	object[]	Returns detailed error information for Form 1099-A records that could not be retrieved or failed validation.
Id	string	Returns the validation error code for the failed Form 1099-A retrieval.
Name	string	Returns the name of the validation rule that failed during the Form 1099-A retrieval.
Message	string	Returns a description of the validation error and guidance on how to resolve it for the Form 1099-A retrieval.

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

Form1099A/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": "8997e07b-575d-41d3-9df3-45f244224013",
        "TaxYear": "2026",
        "IsFederal": true,
        "IsState": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "IsScheduleFiling": false,
        "ScheduleFiling": null
      },
      "ReturnHeader": {
        "Business": {
          "BusinessId": "f9816f1e-1662-4d0c-ab44-948a1228a848",
          "PayerRef": null,
          "IsDefaultBusiness": false,
          "IsActive": true,
          "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": "(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": "37a9e556-7db0-4ab4-8681-223ab6857b3c",
          "ReturnManifest": {
            "IsFederal": true,
            "IsState": false,
            "IsDistribution": true,
            "DistributionDetails": {
              "DistributionType": "POSTAL_AND_ONLINE",
              "PostalType": "USPS_FIRST_CLASS"
            },
            "CorrectionDetails": null,
            "IsForced": false
          },
          "Recipient": {
            "RecipientId": "7b3e9cb9-4968-4ce9-a615-6b9033c9d1d1",
            "PayeeRef": null,
            "TINDetails": {
              "Format": "PLAIN_TIN",
              "TINType": "SSN",
              "TIN": "321-44-5782"
            },
            "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
          },
          "AFormData": {
            "AcqDt": "03/04/2025",
            "OutStandingBal": 1508.75,
            "FMV": 5000.99,
            "IsBorrowerLiable": false,
            "PropDesc": "Single 125 Oak Avenue, Austin, CA",
            "AccountNum": "ACC123456789"
          }
        }
      ],
      "StateReconData": null
    }
  ],
  "Errors": null
}

  package main

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

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

      client := &http.Client{}

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

      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:")
      fmt.Println(string(body))
  }

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

  let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/Form1099A/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/Form1099A/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/Form1099A/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/Form1099A/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/Form1099A/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/Form1099A/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