List

List

Lists all Form 941 returns in TaxBandits that have been created and transmitted for a Submission or Payer. Based on the filters supplied in the request, the results will be listed. If you provide a BusinessId, for example, all returns created under that BusinessId will be listed.

The IRS has removed the COVID-related fields in Form 941 from tax year 2024. To refer to the documentation of Form 941 for tax year 2023,click here.

GET Form941/List 

Run in Postman

Request Params

Field	Type	Description
BusinessId	Guid	Optional Unique identifier of a business
EIN	string	Optional Employer Identification Number
Page	number	Optional Pulls the page number of the page selected
PageSize	number	Optional Number of 941 records to be listed in each page. Note: PageSize can be maximum of 100.
EfileStatus	string	Optional List the 941 records based on the status Allowed values "Accepted", "Rejected", "Transmitted", "Created"
FromDate	string	Optional Enter a date from which the form 941 records need to be listed in MM/DD/YYYY format.
ToDate	string	Optional Enter a date till which the 941 records created are to be listed in MM/DD/YYYY format.

Response Body

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
Form941Records	object[]	Returns detailed information of the Form 941 records.
SubmissionId	Guid	Unique identifier of a submission.
BusinessId	Guid	Unique Identifier of the business.
BusinessNm	string	Name of the business.
PayerRef	string	Unique identifier of the payer.
EIN	Guid	Employer identification Number.
BusinessType	string	Type of the return to be filed. Like as FORM941, FORM941PR, FORM941SS.
RecordId	Guid	Unique identifier of a record.
TaxYr	string	Tax year of Form 941 to be filed.
Qtr	string	Quarter of Form 941 to be filed.
IRSPaymentType	string	Payment type to make payments to the IRS.
EFileStatus	string	List the Form 941 records based on the status.
TotalRecords	number	Total number of records.
TotalPages	number	Total number of pages.
Page	number	Pulls the page number of the page selected.
PageSize	number	Number of 941 records to be listed in each page.
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	List all the 941 returns created for the particular BusinessId and Date range.

Sample 1

"Form941/list?BusinessId=1e26b037-c1db-4d45-957c-7b4836535ca7&EIN=236598859&Page=1&PageSize=2&EfileStatus=ALL&FormDate=null&ToDate=null"

Response Json

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

Response: 200

{
  "StatusCode": 200,
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "Form941Records": [
      {
          "SubmissionId": "66c6e0c7-251e-4f00-8a75-14b5656a59db",
          "BusinessId": "1e26b037-c1db-4d45-957c-7b4836535ca7",
          "PayerRef": "Payerref001",
          "BusinessNm": "ABC Enterprises",
          "EIN": "23-6598859",
          "BusinessType": "CORP",
          "RecordId": "8f85ff98-55ea-4fa9-bc20-7abe02625d14",
          "TaxYr": "2025",
          "Qtr": "Q4",
          "IRSPaymentType": "EFTPS",
          "ReturnType": "Form941",
          "EFileStatus": "CREATED"
      }
  ],
  "TotalRecords": 1,
  "TotalPages": 1,
  "Page": 1,
  "PageSize": 2,
  "Errors": null
}

Node.js

Python

Java

.NET C#