Status

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.

GET acaformutility/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 is created. Mention the return's Record ID that you want to get the status.

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier generated for the submission.
FormACARecords	object[]	Returns the Status of processed records along with their federal, state, and distribution statuses.
SuccessRecords	Object[]	It will show the detailed information about the success status of Form ACA Records.
RecordId	Guid	Unique identifier generated for the submitted tax form record.
FormType	string	Denotes the type of the form.
TaxYear	string	Tax year of Form 1095-B was filed.
AttachedCnt	number	Number of 1095-B Forms Filed with this return.
Form1095BRecords	Object[]	Represents the collection of Form 1095-B records associated with the submission.
Form1095SeqNum	String	Unique sequence number used to identify the Form 1095-B record within the submission.
Form1095BId	String	Unique identifier assigned to the Form 1095-B record.
Employee	object	Contains EmployeeId, EmployeeName, and SSN information of the Employee for whom the 1095-B is filed.
EmployeeId	Guid	An 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.
EmployeeNm	Guid	Name of the employee.
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.
StatesStatus	object[]	Returns the filing status details for each state where the return was filed.
StateCd	string	Two-letter state code for the filing jurisdiction.
StatusCd	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).
Info	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).
Info	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.
CreatedTs	string
LastUpdatedTs	string
ErrorRecords	object[]	It will show the detailed information about the error status of the Form ACA forms Records.
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

Payload

Request Params

Sample	Description	Action
Sample 1	Query Params - Get status using SubmissionId and RecordIds.

Sample 1

ACAForm/Status?SubmissionId=9d71ae45-df5f-49f7-86f8-e88f54132fa

Response JSON

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

Response: 200

{
  "SubmissionId": "e50c27b8-631c-45f0-be19-f786fc69ba60",
  "FormACARecords": {
    "SuccessRecords": {
      "RecordId": "cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b",
      "FormType": "Form1095B",
      "TaxYear": "2026",
      "AttachedCnt": 1,
      "Form1095BRecords": [
        {
          "Form1095SeqNum": "1",
          "Form1095BId": "d4e74407-b4e4-4a85-aec3-e75fe9f687b6",
          "EmployeeId": "cc3e409b-c34f-492b-ac1a-2a5333e823b4",
          "EmployeeNm": "Steve Michal Waugh",
          "FederalStatus": {
            "StatusCd": "FED-002",
            "Status": "TRANSMITTED",
            "Info": "Transmitted to IRS",
            "StatusTs": "2026-01-25T09:00:00-05:00"
          },
          "StatesStatus": [
            {
              "StateCd": "AZ",
              "StatusCd": "ST-002",
              "Status": "TRANSMITTED",
              "Info": "Transmitted to AZ",
              "StatusTs": "2026-01-25T09:01:12-05:00"
            }
          ],
          "Distribution": {
            "DistributionType": "POSTAL_AND_ONLINE",
            "PostalStatus": {
              "PostalType": "USPS_FIRST_CLASS",
              "Code": "POS-004",
              "Status": "HANDED_OVER_TO_USPS",
              "Info": "Handed off to USPS",
              "StatusTs": "2026-01-26T14:30:00-05:00"
            },
            "OnlineAccessStatus": {
              "Email": "shawn@sample.com",
              "Code": "OA-003",
              "Status": "EMAIL_SENT",
              "Info": "Notification email sent",
              "StatusTs": "2026-01-25T09:05:00-05:00"
            },
            "CreatedTs": "2026-01-02T02:17:04-05:00",
            "LastUpdatedTs": "2026-01-26T14:30:00-05:00"
          }
        }
      ]
    },
    "ErrorRecords": null
  },
  "Errors": null
}

Node.js

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);
});

Python

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

.NET C#

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());

Ruby

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

Java

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

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 ''