StatusLog

StatusLog

This endpoint retrieves the status log summary for a transmitted Form W-2 return, including status details for Federal filing, State filing, Online Access, and Postal Mailing.

GET formw2/statuslog 

Run in Postman

Request Body

Field	Type	Description
RecordId	GUID	A unique RecordIdentifier generated by TaxBandits when a W-2 return is created.

Response Body

Field	Type	Description
SubmissionId	GUID	Unique identifier generated by TaxBandits when a W-2 submission is created.
RecordId	GUID	Unique RecordId generated by TaxBandits when the W-2 return is created.
FormType	string	Form type of the return.
FederalStatusLog	Object[]	List of federal status log entries for the return.
Status	string	Federal status of the return.
Message	string	Additional information about the status.
StatusTs	string	Date and time when the status was updated.
StateStatusLog	Object[]	List of state status log entries for the return.
StateCd	string	Return's state code.
Status	string	State status of the return.
Message	string	Additional information about the status.
StatusTs	string	Date and time when the status was updated.
OnlineAccessStatusLog	Object[]	List of online access status log entries.
Email	string	Email address used for online access.
Status	string	Online access status of the return.
Message	string	Additional information about the status.
StatusTs	string	Date and time when the status was updated.
PostalStatusLog	Object[]	List of postal mailing status log entries.
PostalType	string	Postal mailing method selected.
Status	string	Postal mailing status of the return.
Message	string	Additional information about the status.
StatusTs	string	Date and time when the status was updated.
Errors	object[]	List of validation errors for state returns.
Id	string	Unique ID of the validation error.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Payload

Request Params

Sample	Description	Action
Sample 1	Get the status log summary for a Form W2 return using RecordId.

Sample 1

formW2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43

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.
401	Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.

Response: 200

{
  "SubmissionId": null,
  "RecordId": null,
  "FormType": "FormW2",
  "FederalStatusLog": [
    {
      "Code": "FED-005",
      "Status": "ACCEPTED",
      "Message": "Accepted by IRS",
      "StatusTs": "2026-01-25T11:42:00-05:00"
    }
  ],
  "StateStatusLog": [
    {
      "StateCd": "AZ",
      "Code": "ST-005",
      "Status": "ACCEPTED",
      "Message": "Accepted by AZ",
      "StatusTs": "2026-01-25T13:08:00-05:00"
    }
  ],
  "OnlineAccessStatusLog": [
    {
      "Email": "shawn@sample.com",
      "Code": "OA-004",
      "Status": "VIEWED_FORM",
      "Message": "Recipient viewed the form",
      "StatusTs": "2026-01-26T08:15:00-05:00"
    }
  ],
  "PostalStatusLog": [
    {
      "PostalType": "USPS_FIRST_CLASS",
      "Code": "POS-007",
      "Status": "ASSUMED_DELIVERED",
      "Message": "Assumed delivered by USPS",
      "StatusTs": "2026-01-30T16:00:00-05:00"
    }
  ],
  "Errors": null
}

Go Lang

package main

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

func main() {
  url := "<APIURL>/v2.0.0/FormW2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43"
  method := "GET"

  client := &http.Client{}

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

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

Node.js

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

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/Formw2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43',
  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/Formw2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43", 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/Formw2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43");
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/Formw2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43")

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/Formw2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43")
  .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/Formw2/statusLog?recordId=2c1b6f7e-3d9a-4a9e-9f6c-5b7d2c8e1a43' --header 'Content-Type: application/json' --header 'Authorization: <ACCESS_TOKEN>' --data ''