Version: 2.0.0

Status

This endpoint can be used to retrieve the status of 1099 returns transmitted via the TaxBandits API. Provide the SubmissionId and RecordId, and the response will return the status of federal filing, state filing, postal mailing, and online access.

Federal Filing

CREATED - The form has been created but not yet transmitted.
TRANSMITTED - The form has been transmitted by the user.
SENT_TO_AGENCY - The form has been sent to the IRS/SSA, and a result is pending.
ACCEPTED - The form has been accepted by the IRS/SSA.
ACCEPTED_WITH_ERRORS - Applicable only to 1099 forms. The IRS has accepted the return with validation errors; a correction must be filed as soon as possible.
(Applicable only for returns filed using the IRIS filing format.)
REJECTED - The form has been rejected by the IRS/SSA due to errors. The user must correct the errors and retransmit.

State Filing

CREATED - The form has been created but not yet transmitted.
TRANSMITTED - The form has been transmitted by the user.
SENT_TO_AGENCY - The form has been sent to the state DOR, and a result is pending.
ACCEPTED - The form has been accepted by the state DOR.
REJECTED - The form has been rejected by the state DOR.

Postal Mailing

CREATED - Postal mailing has been opted for.
ORDER_RECEIVED - TaxBandits has processed the order to our vendor, and it will be sent to USPS soon.
POSTAL_INITIATED - TaxBandits has processed the order to our vendor, and it will be sent to USPS soon.
HANDEDOVER_TO_USPS - Our vendor has handed over the order to USPS.
MAILED - Our vendor has handed over the order to USPS.
IN_TRANSIT - The USPS has processed the order, and it is currently In-Transit and will reach your recipients soon.
OUT_FOR_DELIVERY - The postal order has reached the final destination, and it is currently Out for Delivery.
ASSUMED_DELIVERED - The postal order has been assumed as delivered to the recipient. (The USPS will not provide the Delivered status for all the mail pieces. If the status doesn't change from Out for Delivery to Assumed Delivered in a couple of Business days, Out for Delivery can be considered as the final status for the orders.)
RE_ROUTED - The order has been re-routed to a change of address registered by the Recipient, or the recipient address is undeliverable, and the order is re-routed to the Payer address.
INTERNATIONAL_EXIT - Our vendor has handed over the order to USPS.

Online Access

CREATED - Online Access has been opted for; a secure download link will be emailed to the recipient once the form is transmitted.
ORDER_RECIEVED - Online Access has been opted for; a secure download link will be emailed to the recipient once the form is transmitted.be sent shortly.
EMAIL_SENT - A secure link to download the form has been emailed to the recipient.
VIEWED_FORM - The recipient has viewed the form.
DOWNLOADED_FORM - The recipient has viewed and downloaded the form.

GET form1099/status

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	A unique identifier of a submission.
RecordIds	Guid	A unique identifier generated by TaxBandits when a return's is created. Mention the return RecordId for which you want to get the status.

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier generated for the submission.
FormType	string	Denotes the type of the form.
1099Records	object[]	Returns the status of processed records along with their federal, state, and distribution statuses.
RecordId	Guid	Unique identifier generated for the submitted tax form record.
FederalStatus	object	Returns the federal filing status details for the record.
Code	string	Status code representing the federal filing result.
Status	string	Current status of the federal filing (for example, ACCEPTED, REJECTED).
Message	string	Detailed description of the federal filing status.
StatusTs	string	Date and time when the federal filing status was last updated.
StateStatus	object	Returns the filing status details for each state where the return was filed.
StateCd	string	Two-letter state code for the filing jurisdiction.
Code	string	Status code representing the state filing result.
Status	string	Current filing status for the specified state.
Message	string	Detailed description of the state filing status.
StatusTs	string	Date and time when the state filing status was last updated.
Distribution	object	Returns the distribution details for the recipient copy of the form.
DistributionType	string	Specifies the distribution method used to deliver the recipient copy (for example, POSTAL_AND_ONLINE).
PostalStatus	object	Returns the postal delivery status information.
PostalType	string	Specifies the postal delivery service used (for example, USPS_FIRST_CLASS).
Code	string	Status code representing the postal delivery status.
Status	string	Current postal delivery status (for example, ASSUMED_DELIVERED, IN_TRANSIT).
Message	string	Detailed description of the postal delivery status.
StatusTs	string	Date and time when the postal delivery status was last updated.
OnlineAccessStatus	object	Returns the online access status information for the recipient.
Email	string	Email address provided for recipient online access.
Code	string	Status code representing the online access status.
Status	string	Current status of online access (for example, VIEWED_FORM, EMAIL_SENT).
Message	string	Detailed description of the online access status.
StatusTs	string	Date and time when the online access status was last updated.
Errors	object[]	Returns top-level validation or processing errors. Returns null when the request is processed successfully.
Id	string	Validation or processing error code.
Name	string	Name of the field or validation rule that caused the error.
Message	string	Detailed description of the error and guidance for resolving it.
ErrorRecords	object[]	It will show the detailed information about the error status of the Form 1099-NEC Records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The `SequenceId` will be returned in the response for your reference.
RecordId	Guid	A unique identifier of a record.
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.
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 - Get status using SubmissionId and RecordIds.

Sample 1

Form1099/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b

Response JSON

Response	Description	Action
200	Success Response - This is a sample response for successful API requests.
400	Bad Request Response - You'll get the below response when your API requests contain any validation errors.

Response: 200

{
  "SubmissionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "FormType": "Form1099NEC",
  "1099Records": [
    {
      "RecordId": "cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b",
      "FederalStatus": {
        "Code": "FED-002",
        "Status": "ACCEPTED",
        "Message": "Accepted by IRS",
        "StatusTs": "2026-01-25T11:42:00-05:00"
      },
      "StateStatus": [
        {
          "StateCd": "AZ",
          "Code": "ST-001",
          "Status": "ACCEPTED",
          "Message": "Accepted by AZ",
          "StatusTs": "2026-01-25T11:43:00-05:00"
        }
      ],
      "Distribution": {
        "DistributionType": "POSTAL_AND_ONLINE",
        "PostalStatus": {
          "PostalType": "USPS_FIRST_CLASS",
          "Code": "POS-006",
          "Status": "DELIVERED",
          "Message": "Stamped delivered by USPS",
          "StatusTs": "2026-01-30T16:00:00-05:00"
        },
        "OnlineAccessStatus": {
          "Email": "shawn@sample.com",
          "Code": "OA-004",
          "Status": "VIEWED_FORM",
          "Message": "Recipient viewed the form",
          "StatusTs": "2026-01-25T15:00:00-05:00"
        }
      }
    }
  ],
  "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

Status

Status

Federal Filing​

State Filing​

Postal Mailing​

Online Access​

Request Body

Response Body

Sample 1

Response: 200

Federal Filing

State Filing

Postal Mailing

Online Access