Skip to main content
Version: 1.7.3

List

GET Form944/List 

Request Params

FieldTypeDescription
BusinessIdGuidOptional Unique identifier of a business.
EINstringOptional Employer Identification Number.
PagenumberOptional Pulls the page number of the page selected
PageSizenumberOptional Number of 944 records to be listed in each page
EfileStatusstringOptional List the 944 records based on the status
FromDatestringOptional Enter a date from which the form Form 944 records need to be listed in MM/DD/YYYY format
ToDatestringOptional Enter a date till which the 944 records created are to be listed in MM/DD/YYYY format.

Request Params

Form944/List?BusinessId=b6d9e695-cc72-46f7-b131-58317a54668b&FromDate=01/01/2023&ToDate=12/31/2023&EfileStatus=CREATED&Page=1&PageSize=10&EIN=144718269

Response Body

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
Form944Recordsobject[]Returns detailed information of the Form 944 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 944 to be filed.
    QtrstringQuarter of Form 944 to be filed.
    IRSPaymentTypestringPayment type to make payments to the IRS.
    EFileStatusstringList the Form 944 records based on the status.
TotalRecordsnumberTotal number of records.
TotalPagesnumberTotal number of pages.
PagenumberPulls the page number of the page selected.
PageSizenumberNumber of 944 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.

Response JSON

Success Response - This is a sample response for successful API requests.

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "496570cd-e218-4f91-83e6-1549ea8ce525",
"Form944Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "7d9a60e8-e6d6-4c1c-9daf-0575f5b3fb69",
"RecordStatus": "DELETED",
"CreatedTs": "2023-10-03 03:00:02 -04:00",
"UpdatedTs": "2023-10-03 03:37:03 -04:00"
}
],
"ErrorRecords": null
},
"Errors": null
}