Form1099W2Status

Form1099W2Status

Use this endpoint to retrieve the status of all 1099 and/or W-2 forms submitted through the TaxBandits API.

Your API request must include the business information and tax year. All other parameters—such as form type, submission ID, record ID, or status—are optional and can be provided based on how you want to filter and retrieve the status results.

You can:

• Include the form type (such as 1099-NEC, 1099-MISC, etc.) to retrieve the list of forms of that type along with their current statuses.
• Provide a SubmissionId to retrieve statuses within a particular submission.
• Include the status code ("Created", "Transmitted", "SentToAgency", "Accepted", "Rejected", "AcceptedWithErrors") if you want to fetch forms by a specific status.

GET Utility/Form1099W2Status 

Run in Postman

Request Params

Field	Type	Description
BusinessId	Guid	A unique identifier of the business (payer or employer) generated by TaxBandits when you’ve added them.
PayerRef	string	A unique identifier of the business (payer or employer) that you have provided while adding them.
TINType	string	TIN type of the business. Allowed values "SSN","EIN"
TIN	string	Enter the nine-digit taxpayer identification number of the Business Size Range: 9-11
SubmissionId	Guid	A unique identifier of a submission.
RecordId	Guid	A unique identifier generated by TaxBandits when a return is created.
FormType	string	The type of form for which you want to retrieve the status. Allowed values "Form1099NEC", "Form1099NecCorrection", "Form1099MISC", "Form1099MiscCorrection", "Form1099K", "Form1099KCorrection", "FormW2", "FormW2C", "Form1099INT", "Form1099INTCorrection", "Form1099DIV", "Form1099DIVCorrection", "Form1099R", "Form1099RCorrection", "Form1099S", "Form1099SCorrection", "Form1099B", "Form1099G", "Form1099GCorrection", "Form1099C", "Form1099PATR", "Form1099Q", "Form1099OID", "Form1099A", "Form1099ACorrection", "Form1099LTC", "Form1099SA", "Form1099SACorrection", "Form5498", "Form5498SA", "Form5498SACorrection", "Form5498ESA", "Form1098", "Form1098Correction", "Form1098E", "Form1098ECorrection", "Form1098T", "FormW2G", "Form1097BTC", "Form3921", "Form3922"
TaxYear	TaxYear	The tax year for which the form is filed. Allowed values "2023", "2024"
Status	string	The current status of the forms you want to retrieve.  Allowed values "Created", "Transmitted", "SentToAgency", "Accepted", "Rejected", "AcceptedWithErrors"
Page	number	Retrieves the records on the page number you specify.
PageSize	number	The number of records to be listed on each page. Maximum: 100.

Response Body

Field	Type	Description
BusinessId	Guid	A unique identifier of the business generated by TaxBandits.
BusinessNm	string	Name of the business.
PayerRef	string	User-defined unique identifier of the business.
FirstNm	string	First name of the individual (For businesses with SSN)
MiddleNm	string	Middle name of the individual (For businesses with SSN)
LastNm	string	Last name of the individual (For businesses with SSN)
Suffix	string	Suffix of the individual (For businesses with SSN)
TINType	String	TIN type of the business.
TIN	String	Taxpayer Identification Number of the business.
TaxYear	string	Tax year for which the form is filed.
Form1099W2Records	object[]	Details about the 1099/W-2 form and the corresponding recipients
FormType	string	The type of form
SubmissionID	Guid	A unique identifier of a submission
RecordId	Guid	A unique identifier of a record
RecipientId	Guid	A unique identifier generated by TaxBandits for a Recipient when a return is created.
PayeeRef	string	A unique identifier of the recipient that you have provided while adding them or when filing forms for them.
AccountNum	string	Account number of the payer when multiple accounts exist for a recipient and more than one form of the same type is filed.
FederalReturn	object	Details about the federal filing status of the forms.
Status	string	The current federal filing status of the forms.
StatusTs	string	Timestamp of the federal filing status update.
Info	string	Additional information about the federal filing.
Errors	object[]	Details about the errors in the federal information on the forms
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
StateReturns	object[]	Details about the state filing status of the forms.
StateCd	string	Two-letter code of the state where the form is filed.
Status	string	The current state filing status of the forms.
StatusTs	string	Timestamp of the state filing status update.
Info	string	Additional information about the state filing
Errors	object[]	Details about the errors in state information of the forms
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Postal	object	Details about the postal mailing status of the forms.
Status	string	The current status of the postal mailing order.
StatusTs	string	Timestamp of the postal order update.
Info	string	Additional information about the postal mailing.
OnlineAccess	object	Details about the online access status of the forms.
Status	string	The current status of the online access order.
Email	string	The recipient’s email address used for online access.
Info	string	Additional details about online access.
ScheduleFiling	object	Details about the scheduled forms
ScheduledOn	string	The date the form is scheduled to be filed with the IRS.
Info	string	Additional information about the scheduled filing.
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

"Utility/Form1099W2?BusinessId=0fa00f91-5596-4e91-b461-019cde9d28e2&TaxYear=2024"

Response JSON

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

{
	"BusinessId": "0fa00f91-5596-4e91-b461-019cde9d28e2",
	"BusinessNm": "Snowdaze LLC",
	"FirstNm": null,
	"LastNm": null,
	"MiddleNm": null,
	"Suffix": null,
	"TINType": "EIN",
	"TIN": "65-7368245",
	"PayerRef": "Snow123",
	"TaxYear": "2024",
	"Form1099W2Records": [
		{
			"FormType": "Form1099NEC",
			"SubmissionId": "f0c2268d-e895-47ae-8a42-b7c905a9f077",
			"RecordId": "9f2c335f-30a9-4b2c-8099-3cab471758ff",
			"RecipientId": "b4552b9a-8a34-4248-8f70-f275dab77ed1",
			"PayeeRef": "Payee001",
			"AccountNum": "20242090026315012246",
			"FederalReturn": {
				"Status": "TRANSMITTED",
				"StatusTs": "2025-07-28 10:40:06 -04:00",
				"Info": null,
				"Errors": null
			},
			"StateReturns": [
				{
					"StateCd": "AZ",
					"Status": "TRANSMITTED",
					"StatusTs": "2025-07-28 06:11:16 -04:00",
					"Info": null,
					"Errors": null
				}
			],
			"Postal": {
				"Status": "RECEIVED",
				"StatusTs": "2025-07-28 10:40:06 -04:00",
				"Info": null
			},
			"OnlineAccess": {
				"Status": "EMAIL_SENT",
				"Email": "shawn@sample.com",
				"Info": null
			},
			"ScheduleFiling": null
		},
		{
			"FormType": "Form1099NEC",
			"SubmissionId": "3813b687-0a55-473b-b92c-c0c616e08225",
			"RecordId": "35a30068-b3d1-4d80-bfae-a106edad9906",
			"RecipientId": "b4552b9a-8a34-4248-8f70-f275dab77ed1",
			"PayeeRef": "Payee002",
			"AccountNum": "20242090026315039463",
			"FederalReturn": {
				"Status": "CREATED",
				"StatusTs": "2025-07-28 06:16:14 -04:00",
				"Info": null,
				"Errors": null
			},
			"StateReturns": [
				{
					"StateCd": "AZ",
					"Status": "CREATED",
					"StatusTs": "2025-07-28 06:11:16 -04:00",
					"Info": null,
					"Errors": null
				}
			],
			"Postal": {
				"Status": "CREATED",
				"StatusTs": "2025-07-28 06:16:14 -04:00",
				"Info": null
			},
			"OnlineAccess": {
				"Status": "CREATED",
				"Email": "shawn@sample.com",
				"Info": null
			},
			"ScheduleFiling": null
		}
	],
	"TotalRecords": 2,
	"TotalPages": 1,
	"Page": 1,
	"PageSize": 100,
	"Errors": null
}