Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.7.0

List

Lists Form 943s created for a date range.

GET Form943/List

Request Parameters

FieldTypeDescription
BusinessIdGuidOptional Unique identifier of a business.
EINstringOptional Employer Identification Number.
PagenumberOptional Pulls the page number of the page selected
PageSizenumberOptional Number of 943 records to be listed in each page
EfileStatusstringOptional List the 943 records based on the status
FromDatestringOptional List 943 records created from
ToDatestringOptional List 943 records created up to

Response Parameters

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
Form943RecordListobject[]Returns detailed information of the Form 943 records.
    SubmissionIdGuidUnique identifier of a submission
    BusinessIdGuidUnique Identifier of the business
    BusinessNmstringName of the business
    EINstringEmployer Identification Number
    BusinessTypestringType of business.
    RecordIdGuidUnique identifier of a record
    TaxYrstringTax year for which Form 943 needs to be filed
    IRSPaymentTypestringPayment type to make payments pay the IRS. Choose from EFW, EFTPS, Check or Money Order
    ReturnTypestringType of the return to be filed. Enter value as FORM943
    EFileStatusstringList the 943 records based on the status.
TotalRecordsnumberTotal number of records.
TotalPagesnumberTotal number of pages.
PagenumberPulls the page number of the page selected
PageSizenumberNumber of 943 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

"Form943/List?BusinessId=c5beb833-2ce4-4293-9772-6c94d37173f2&EIN=005498751&Page=1&PageSize=10&EfileStatus=null&FromDate=01/01/2020&ToDate=02/10/2020"

Response JSON

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form943RecordList": [
{
"SubmissionId": "7f9cb1ab-f90b-4358-ae5f-acfe19617d96",
"BusinessId": "c5beb833-2ce4-4293-9772-6c94d37173f2",
"BusinessNm": "Rhona Agri Company",
"EIN": "11-1234567",
"BusinessType": "Estate",
"RecordId": "22af7b4b-42f2-4e68-a9ac-743d2fd76636",
"TaxYr": "2019",
"IRSPaymentType": "EFTPS",
"ReturnType": "ORIGINAL",
"EFileStatus": "CREATED"
}
],
"TotalRecords": 1,
"TotalPages": 1,
"Page": 1,
"PageSize": 10,
"Errors": null
}