List
Lists Form 943s created for a date range.
The IRS has removed the COVID-related fields in Form 943 for tax year 2024. To refer to the documentation of Form 943 for tax year 2023,click here.
GET Form943/List
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 943 records to be listed in each page. Note: PageSize can be maximum of 100. |
EfileStatus | string | Optional List the 943 records based on the status |
FromDate | string | Optional Enter a date from which the form Form 943 records need to be listed in MM/DD/YYYY format |
ToDate | string | Optional Enter a date till which the 943 records created are to be listed in MM/DD/YYYY format. |
Request Params
"Form943/List?BusinessId=4c989e5e-5b9a-44ed-a632-3247899a3f70"
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. |
Form943RecordList | object[] | Returns detailed information of the Form 943 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 | string | Employer Identification Number |
BusinessType | string | Type of business. |
RecordId | Guid | Unique identifier of a record |
TaxYr | string | Tax year for which Form 943 needs to be filed |
IRSPaymentType | string | Payment type to make payments pay the IRS. Choose from EFW, EFTPS, Check or Money Order |
ReturnType | string | Type of the return to be filed. Enter value as FORM943 |
EFileStatus | string | List the 943 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 943 records to be listed in each page. |
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. |
Type | string | Type of validation error. |
Response JSON
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form943RecordList": [
{
"SubmissionId": "e59dc3a7-a150-415a-b92d-13db7ba8ee62",
"BusinessId": "4c989e5e-5b9a-44ed-a632-3247899a3f70",
"PayerRef": "payerref001",
"BusinessNm": "Snowdaze LLC",
"EIN": "25-3122557",
"BusinessType": "CORP",
"RecordId": "5ef362ae-ba83-45dc-868b-c7a0eab2920e",
"TaxYr": "2024",
"IRSPaymentType": "CHECK_OR_MO",
"ReturnType": "Form943",
"EFileStatus": "CREATED"
}
],
"TotalRecords": 1,
"TotalPages": 1,
"Page": 1,
"PageSize": 100,
"Errors": null
}