Form94XStatus

Form94XStatus

Use this endpoint to retrieve the status of all 94x 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 941, 944, 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", "Accepted", "Rejected") if you want to fetch forms by a specific status.

GET Utility/Form94XStatus 

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 "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.
RecordIds	Guid	A unique identifier generated by TaxBandits when a return is created.
ReturnType	string	The type of form for which you want to retrieve the status.  Allowed values "FORM940","FORM941","FORM941X","FORM943","FORM944","FORM945","FORM940SCHR","FORM941SCHR"
Status	string	The current status of the forms you want to retrieve.  Allowed values "Created", "Transmitted", "Accepted", "Rejected"
TaxYear	TaxYear	The tax year for which the form is filed. Allowed values "2023", "2024", "2025"
Qtr	string	Quarter of Form filed. Allowed values "Q1", "Q2", "Q3", "Q4" Note: This node is only applicable for "FORM941" and "FORM941X"
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.
TINType	String	TIN type of the business.
TIN	String	Taxpayer Identification Number of the business.
PayerRef	string	User-defined unique identifier of the business.
TaxYear	string	Tax year for which the form is filed.
Qtr	string	Quarter for which the form is filed
FormRecords	object[]	Pulls the Form 94X records with Success and Error statuses.
FormType	string	The type of form
SubmissionID	Guid	A unique identifier of a submission
RecordId	Guid	A unique identifier of a record
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
Errors	object[]	Shows detailed error information.
Code	string	Returns the validation error code.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request Params

"Utility/Form94xStatus?BusinessId=1e26b037-c1db-4d45-957c-7b4836535ca7&PayerRef=Payer001&TINType=EIN&TIN=768564758&SubmissionId=71454e6b-fb3e-487a-9582-688214f03fb8&RecordId=5ef362ae-ba83-45dc-868b-c7a0eab2920e&ReturnType=FORM944&Status=Transmitted&TaxYear=2023&Qtr=Q1&Page=1&PageSize=1"

Response JSON

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

{
  "BusinessId": "1e26b037-c1db-4d45-957c-7b4836535ca7",
  "BusinessNm": "DkartEnterprises",
  "TINType": "SSN",
  "TIN": "567485967",
  "PayerRef": "Payer001",
  "TaxYear": "2023",
  "Qtr": null,
  "FormRecords":[
    {
      "FormType": "FORM944",
      "SubmissionId": "9d71ae45-df5f-49f7-86f8-e88f54132fa1",
      "RecordId": "01132f6d-ef4a-4014-817e-94a5a19bd52b",
      "RecordStatus": "Created",
      "CreatedTs": "2025-03-20 03:50:02 -04:00",
      "UpdatedTs": "2025-03-20 03:51:45 -04:00"
    },
    {
      "FormType": "FORM944",
      "SubmissionId": "9d71ae45-df5f-49f7-86f8-e88f54132fa1",
      "RecordId": "01132f6d-ef4a-4014-817e-94a5a19bd52b",
      "RecordStatus": "Created",
      "CreatedTs": "2025-03-20 03:50:02 -04:00",
      "UpdatedTs": "2025-03-20 03:51:45 -04:00"
    }
    ],
  "Errors": null,
  "TotalRecords": 2,
  "TotalPages": 1,
  "Page": 1,
  "PageSize": 100
}