StatusLog

StatusLog

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

GET form1099w2/statuslog 

Run in Postman

Request Body

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

Response Body

Field	Type	Description
SubmissionId	GUID	Unique identifier generated by TaxBandits when a 1099/W-2 submission is created.
RecordId	GUID	Unique RecordId generated by TaxBandits when the 1099/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.

Request JSON

Sample	Description	Action
Sample 1	Get the status log summary for a Form 1099/W-2 return using RecordId.

Sample 1

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

Response JSON

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

Response: 200

{
"SubmissionId": "",
"RecordId": "",
"FormType": "Form1099NEC",
"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
}