Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.6.1

List

Lists Form 941s created for a date range.

GET Form941/List

Request Body

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

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.

Request JSON

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

Response JSON

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