List
List
Lists Form 940SCHRs created for a date range.
GET Form940SchR/List Request Params
| Field | Type | Description |
|---|---|---|
| BusinessId | Guid | Unique identifier of a business |
| EIN | string | Employer Identification Number |
| Page | number | Pulls the page number of the page selected |
| PageSize | number | Number of 940SCHR records to be listed in each page Note: PageSize can be maximum of 100. |
| EfileStatus | string | List the 940SCHR records based on the status |
| FromDate | string | Enter a date from which the form 940SCHR records need to be listed in MM/DD/YYYY format |
| ToDate | string | Enter a date till which the 940SCHR 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. |
| Form940SchRRecordList | object[] | Returns detailed information of the Form 940SCHR records. |
| SubmissionId | Guid | Submission Identifier |
| BusinessId | Guid | Business Identifier |
| BusinessNm | string | Business Name |
| EIN | string | Employer Identification Number |
| BusinessType | string | Business Type |
| RecordId | Guid | Record Identifier |
| TaxYr | string | Tax Year |
| IRSPaymentType | string | IRS Payment Type |
| ReturnType | string | Return Type |
| EFileStatus | string | Efile Status (Created, Transmitted, Accepted, Rejected) |
| ClientCnt | number | Number of Clients reported. |
| ClientRecordId | Guid[] | Unique identifier of each client record. |
| TotalRecords | number | Total number of Businesses |
| TotalPages | number | Total number of pages |
| Page | number | Pulls the page number of the page selected |
| PageSize | number | Number of 940SCHR 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
"Form940SCHR/List?BusinessId=e0e21430-ca3a-4573-bb70-f792ff160ca1&EIN=007820414&Page=1&PageSize=10&EfileStatus=null&FromDate=07/01/2021&ToDate=03/31/2021"
Response JSON
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form940SchRRecordList": [
{
"ClientCnt": 2,
"ClientRecordId": [
"3982d093-1838-404b-8b0c-9bc1491c9701",
"11aa7f66-9bfd-449e-af4c-cdaefd8fc20b"
],
"EFileStatus": "CREATED",
"SubmissionId": "9723f666-c46e-43e6-8c56-8cba391acbf7",
"BusinessId": "e0e21430-ca3a-4573-bb70-f792ff160ca1",
"BusinessNm": "Snowdaze LLC",
"EIN": "00-7820414",
"BusinessType": "Estate",
"RecordId": "e6e465db-f293-44e6-b659-3e528ea0cec7",
"TaxYr": "2020",
"IRSPaymentType": null,
"ReturnType": "Form940SCHR"
}
],
"TotalRecords": 1,
"TotalPages": 1,
"Page": 1,
"PageSize": 10,
"Errors": null
}