Version: 2.0.0

Get

Use this endpoint to retrieve a 1099-G 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 form1099g/get

Run in Postman

Request Body

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

Response Body

Field	Type	Description
Form1099Records	object[]	Contains information about Form 1099-G 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
TaxYear	string	Tax year of Form 1099-G to be filed. Allowed values Allowed values: "2025", "2026"
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	When true, schedule filing services will be provided for Form 1099-G returns under this submission.
ScheduleFiling	object[]	Contains the preferred date to submit the returns to the IRS. Note: Required only when `IsScheduleFiling` is True.
EfileDate	string	Date of Schedule Filing. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY Example: 01/25/2026 or 01-25-2026
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	Guid	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.
PayerRef	string	Optional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
IsDefaultBusiness	Boolean	When set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetails	object	TIN information for the business
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	Specify the TIN type of the business. Allowed values "EIN", "SSN"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN. Provide individual name fields instead of BusinessNm.
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. Required when TINType is EIN.
NameCtrl	string	Name control of the business as registered with the IRS.
DBADetails	object[]	DBA (Doing Business As) information. Optional at creation — additional DBAs can be added later via AddDBA.
DBANm	string	Name of the DBA.
DBARef	string	Your unique identifier for this DBA.
DBAId	GUID	TaxBandits-generated DBA identifier. Returned in the response.
IsDefaultDBA	Boolean	When TRUE, marks this DBA as the default.
Address	object[]	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[]	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-G details.
SequenceId	string	A 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.
RecordId	Guid	Unique Identifier of the Record. Mention the Form 1099-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.
ReturnManifest	object[]	Filing options for this record
IsFederal	Boolean	Federal Filing for the return will be enabled when the value is True. Form 1099-G will be sent directly to the IRS.
IsState	Boolean	State Filing for the return will be enabled when the value is True. Form 1099-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.
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.
PostalType	string	Postal service type.
IsForced	Boolean	When TRUE, TaxBandits does not verify for duplicates and will create a new return for the recipient, even if it comprises the same amount as in previously filed returns. For more information on duplicate handling for Form 1099s, please click here.
Recipient	object	Object to identify the recipient details.
RecipientId	Guid	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.
PayeeRef	string	Optional Your unique identifier for the recipient. Can replace RecipientId in future requests.
TINDetails	object	Recipient TIN information.
Format	string	Specifies how the TIN is passed.
TINType	string	Specify the TIN type of the recipient. Allowed values "EIN", "SSN", "ATIN", "ITIN", "NA"
TIN	string	The TIN value, formatted according to the Format field selected.
IndividualNm	Object	Required when TINType is SSN, ITIN, or ATIN. Provide individual name fields instead of BusinessNm.
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	Name control of the business as registered with the IRS.
DBADetails	Object	Optional DBA (Doing Business As) information. Optional at creation — additional DBAs can be added later via AddDBA.
DBAId	GUID	TaxBandits-generated DBA identifier. Returned in the response.
DBANm	String	Name of the DBA.
DBARef	String	Your unique identifier for this DBA.
Address	Object	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	Date of Birth of the recipient. Format: MM/DD/YYYY
Address	Object	Primary address of the recipient.
Address1	String	Street address or PO Box of the recipient. Max 46 characters
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.
GFormData	object	Recipient's Form 1099-G information.
UnempComp	number	Unemployment Compensation - Get payments of $10 or more in unemployment compensation, before any income tax was withheld. Size Range: 0-9999999999.99
TaxRefunds	number	State or Local Income Tax Refunds, Credits, or Offsets - Get refunds, credits, or offsets of state or local income tax of $10 or more you made to recipients. Size Range: 0-9999999999.99
TaxYearOfB2Amt	string	Box 2 Amount Is For Tax Year Get the year for which the refund, credit, or offset was made. Get the year in "YYYY" Format.
FedTaxWH	number	Federal Income Tax Withheld - Get backup withholding on payments required or any voluntary federal withholding on unemployment compensation. Size Range: 0-9999999999.99 Note : This value should be less than 40% of the sum of boxes 5, 6, 7.
RTAAPayments	number	RTAA Payments - Get RTAA payments of $600 or more that paid to eligible individuals under the Reemployment Trade Adjustment Assistance program. Size Range: 0-9999999999.99
TaxableGrants	number	Taxable Grants - Get any amount of a taxable grant administered by a federal, state, or local program. Size Range: 0-9999999999.99
AgriPayments	number	Agriculture Payments - Get agricultural subsidy payments made during the year. Size Range: 0-9999999999.99
IsTradeOrBizIncome	Boolean	When true, the amount in box 2 is a refund, credit, or offset attributable to an income tax that applies exclusively to income from a trade or business and is not a tax of general application.
MarketGain	number	Market Gain - Get market gain associated with the repayment of a CCC loan. Size Range: 0-9999999999.99
FamilyLeaveBenefits	number	Total family leave benefits paid under a governmental (PFML) program before any federal income tax withholding Size Range: 0-9999999999.99
AccountNum	string	Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-G is filed. Size Range: 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.
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.
States	object[]	Contains list of state returns information.
StateCd	string	State Code. Size Range: 2
StateIdNum	string	Identification Number of State. Size Range: ..20
StateWH	number	Income tax amount withheld for State. Size Range: 0-9999999999.99

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

Form1099G/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 a successful get request.

Response: 200

{
  "Form1099Records": [
    {
      "SubmissionManifest": {
        "SubmissionId": "e50c27b8-631c-45f0-be19-f786fc69ba60",
        "TaxYear": "2026",
        "IsFederal": true,
        "IsState": true,
        "IsDistribution": true,
        "DistributionDetails": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "PostalType": "USPS_FIRST_CLASS"
        },
        "IsScheduleFiling": true,
        "ScheduleFiling": {
          "EfileDate": "01/25/2026"
        }
      },
      "ReturnHeader": {
        "Business": {
          "PayerRef": "Snow123",
          "BusinessId": null,
          "IsDefaultBusiness": true,
          "TINDetails": {
            "Format": "PLAIN_TIN",
            "TINType": "EIN",
            "TIN": "45-9875461"
          },
          "IndividualNm": {
            "FirstNm": "James",
            "MiddleNm": "A",
            "LastNm": "Anderson",
            "Suffix": "Jr"
          },
          "BusinessNm": "Snowdaze LLC",
          "NameCtrl": "SNOW",
          "DBADetails": {
            "DBANm": "Iceberg Icecreams",
            "DBARef": "DBA1001",
            "DBAId": null,
            "IsDefaultDBA": true,
            "Address": {
              "Address1": "123 Main St",
              "Address2": "Suite 1001",
              "City": "Rock Hill",
              "ProvinceOrState": "SC",
              "ZipCd": "29730",
              "Country": "US"
            }
          },
          "Email": "james@sample.com",
          "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": "8035551234",
            "PhoneExtn": "101",
            "Email": "contact@snowdaze.com",
            "Fax": "8035555678"
          }
        }
      },
      "ReturnData": [
        {
          "SequenceId": "1",
          "RecordId": "cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b",
          "IsFederal": true,
          "IsState": true,
          "IsDistribution": true,
          "DistributionDetails": {
            "DistributionType": "SMART_MAIL",
            "PostalType": "USPS_FIRST_CLASS"
          },
          "IsForced": false,
          "Recipient": {
            "PayeeRef": "DAI001",
            "TINDetails": {
              "Format": "PLAIN_TIN",
              "TINType": "EIN",
              "TIN": "45-9875461"
            },
            "IndividualNm": {
              "FirstNm": "James",
              "MiddleNm": "A",
              "LastNm": "Anderson",
              "Suffix": "Jr",
              "DOB": null
            },
            "BusinessNm": "Snowdaze LLC",
            "NameCtrl": "SNOW",
            "DBADetails": {
              "DBANm": "Iceberg Icecreams",
              "DBARef": "DBA1001",
              "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"
            },
            "Email": "shawn@sample.com",
            "Fax": "6634567890",
            "Phone": "9634567890"
          },
          "GFormData": {
            "UnempComp": 7010.27,
            "TaxRefunds": 97,
            "TaxYearOfB2Amt": 2024,
            "FedTaxWH": 70.23,
            "RTAAPayments": 390,
            "TaxableGrants": 230,
            "AgriPayments": 340,
            "IsTradeOrBizIncome": false,
            "MarketGain": 435,
            "FamilyLeaveBenfits": 123,
            "Is2ndTINnot": false,
            "AccountNum": "587879879879",
            "States": null
          }
        }
      ],
      "StateReconData": null
    }
  ],
  "Errors": null
}

package main

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

func main() {
  url := "<APIURL>/v2.0.0/Form1099G/Get?SubmissionId=519a84f4-5e56-496a-82f3-18f51fdf3d75&RecordIds=519a84f4-5e56-496a-82f3-18f51fdf3d75%2C519a84f4-5e56-496a-82f3-18f51fdf3d75"

  req, err := http.NewRequest(http.MethodGet, url, nil)
  if err != nil {
    fmt.Println("Request creation error:", 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("Request failed:", err)
    return
  }
  defer res.Body.Close()

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

  fmt.Printf("Status: %s
", res.Status)
  fmt.Println(string(body))
}

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

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

Response Body

Sample 1

Response: 200