Skip to main content
Version: 1.7.3

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.

GET Form941/List 
Run in Postman

Request Params

FieldTypeDescription
BusinessIdGuidUnique identifier of a business
EINstringEmployer Identification Number
PagenumberPulls the page number of the page selected
PageSizenumberNumber of 941 records to be listed in each page
EfileStatusstringList the 941 records based on the status
FromDateDateTimeList 941 records created from
ToDateDateTimeList 941 records created up to

Request Params

List all the 941 returns created for the particular BusinessId and Date range.

"Form941/List?BusinessId=730f3e93-f5d8-490f-9deb-36bbf158e51c&EIN=006587034&Page=0&PageSize=0&EfileStatus=ALL&FromDate=null&ToDate=null"

Response Body

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
Form941Recordsobject[]Returns detailed information of the Form 941 records.
    SubmissionIdGuidUnique identifier of a submission.
    BusinessIdGuidUnique Identifier of the business.
    BusinessNmstringName of the business.
    EINGuidEmployer identification Number.
    BusinessTypestringType of the return to be filed. Like as FORM941, FORM941PR, FORM941SS.
    RecordIdGuidUnique identifier of a record.
    TaxYrstringTax year of Form 941 to be filed.
    QtrstringQuarter of Form 941 to be filed.
    IRSPaymentTypestringPayment type to make payments to the IRS.
    EFileStatusstringList the Form 941 records based on the status.
TotalRecordsnumberTotal number of records.
TotalPagesnumberTotal number of pages.
PagenumberPulls the page number of the page selected.
PageSizenumberNumber of 941 records to be listed in each page.
Errorsobject[]Shows detailed error information.
    CodestringReturns the validation error code.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.
    TypestringType of validation error.

Response JSON

The Response Payload will list all the returns created for the given BusinessId based on the given date range.

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form941Records": [
{
"SubmissionId": "909a8bc8-f60b-4d90-8bb3-247be7179ace",
"BusinessId": "730f3e93-f5d8-490f-9deb-36bbf158e51c",
"BusinessNm": "ABC LLC",
"EIN": "006687034",
"BusinessType": "CORP",
"RecordId": "cba7aa73-6104-476d-99f7-e8ac2dea7f0a",
"TaxYr": "2023",
"Qtr": "Q3",
"IRSPaymentType": "EFTPS",
"ReturnType": "Form941",
"EFileStatus": "CREATED"
},
{
"SubmissionId": "747a8bc8-f60b-4d90-8bb3-247be7179ace",
"BusinessId": "730f3e93-f5d8-490f-9deb-36bbf158e51c",
"BusinessNm": "ABC LLC",
"EIN": "006687034",
"BusinessType": "CORP",
"RecordId": "abc7aa73-6104-476d-99f7-e8ac2dea7f0a",
"TaxYr": "2023",
"Qtr": "Q3",
"IRSPaymentType": "EFTPS",
"ReturnType": "Form941",
"EFileStatus": "CREATED"
}
],
"TotalRecords": 2,
"TotalPages": 1,
"Page": 1,
"PageSize": 100,
"Errors": null
}