List
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 Allowed values"Accepted", "Rejected", "Transmitted", "Created" |
| FromDate | string | Optional Enter a date from which the 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. |
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. |
Request Params
"Form943/List?BusinessId=4c989e5e-5b9a-44ed-a632-3247899a3f70"
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
}