Skip to main content
Version: 2.0.0

Get

Get

Use this endpoint to retrieve the information of a previously created CT-941 form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the form.

GET StateFilings/CT941WH/Get 

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
RecordIdGuidAn unique identifier generated by TaxBandits when a Form CT-941 return is created. Mention the return's Record ID that you want to get.

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
StateWHRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form CT-941 is to be filed.
QtrStringThe quarter for which the Form CT-941 is to be filed.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidThe unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint.
PayerRefstringUnique identifier for the payer. Can replace BusinessId in future requests.
IsDefaultBusinessBooleanWhen set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetailsobjectTIN information for the business.
FormatstringSpecifies how the TIN is passed.
TINTypestringThe TIN type of the business.
TINstringThe TIN value according to the Format selected.
IndividualNmobjectRequired when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNmstringThe first name of the individual.
MiddleNmstringMiddle name of the individual.
LastNmstringThe last name of the individual.
SuffixstringSuffix of the individual's name.
BusinessNmstringLegal name of the business.
NameCtrlstringName control of the business as registered with the IRS.
DBADetailsobject[]DBA (Doing Business As) information.
DBANmstringName of the DBA.
DBARefstringUnique identifier for the DBA.
DBAIdGuidTaxBandits-generated DBA identifier.
Addressobject[]Address information of the DBA.
Address1stringStreet address or PO Box.
Address2stringSuite or apartment number.
CitystringDBA's city.
ProvinceOrStatestringDBA's province or state name.
ZipcdstringDBA's ZIP code.
CountrystringDBA's 2-character country code.
EmailstringEmail address of the Business.
AddressobjectPrimary address of the business.
Address1stringStreet address or PO Box of the business.
Address2stringSuite or apartment number of the business.
CitystringCity of the business.
ProvinceOrStatestringProvince or state name of the business.
ZipCdstringZIP code of the business.
Countrystring2-character country code of the business.
ContactDetailsobject[]Details of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person.
MiddleNmstringOptional Middle name of the contact person.
LastNmstringLast name of the contact person.
SuffixstringThe suffix of the contact person.
PhonestringPhone number of the contact person.
PhoneExtnstringPhone extension number.
EmailstringEmail address of the contact person.
FaxstringFax number of the contact person.
SigningAuthorityObjectDetails of the person authorized to sign the return.
FirstNmStringFirst name of the signatory.
MiddleNmStringMiddle name of the signatory.
LastNmStringLast name of the signatory.
SuffixStringThe suffix of the signatory.
PhoneStringPhone number of the signatory.
PhoneExtnStringPhone extension number of the signatory.
BusinessMemberTypeStringTitle or role of the signatory.
ReturnDataObject[]Identifies the Form CT-941 data.
FormCT941ObjectConnecticut withholding tax return.
WHIdNumStringConnecticut withholding ID number.
IsFinalReturnBooleanIf true identifies that the payer no longer has any employees and no payroll has been carried forward.
OperationCeasedDtStringDate when the last payroll was processed
TotWagesNumberGross wages paid for the quarter
TotCTWagesNumberGross wages paid, subject to Connecticut withholding, for the quarter
TotTaxWHNumberConnecticut tax withheld for the quarter
OverpaymentNumberOverpayment Credit from prior quarter
TotTaxPaidNumberPayments made for this quarter
TotPaymentNumberTotal payments from tax withheld and overpayment Credit from prior quarter
TotWHDueNumberNet tax due for the quarter
PenaltyNumberPenalty for the quarter
InterestNumberInterest due for the quarter
TotPenaltyInterestNumberTotal penalties and interest due amount
CreditNumberAmount to be credited
RefundNumberAmount to be refunded
BalanceDueNumberTotal tax amount due
PayPeriodObject[]Object that contains tax liability details for the quarter
PayDateStringDate when the payment was made.
Month1AmtNumberLiability amount for first month of the quarter
Month2AmtNumberLiability amount for second month of the quarter
Month3AmtNumberLiability amount for third month of the quarter
TotMonth1TaxLiabNumberTotal tax liability for the first month of the quarter
TotMonth2TaxLiabNumberTotal tax liability for the second month of the quarter
TotMonth3TaxLiabNumberTotal tax liability for the second month of the quarter
TotTaxLiabNumberTotal tax liability for the quarter
StatePaymentObjectObject that contains information about the payment details
PaymentAmtNumberAmount to be paid
BankRoutingNumstringBank Routing Number of payment
BankAccountNumstringBank Account Number for payment
AccountTypestringBank account type
PaymentReqDateStringDate when the payment has to be made.
StateRefundAccountObjectObject that contains information about the refund account details
AccountTypestringBank account type
BankRoutingNumstringBank Routing Number of payment
BankAccountNumstringBank Account Number for payment
IsForeignBankAccBooleanIf true identifies that provided account details belong to a foreign account.
Errorsobject[]Shows detailed error information
IdstringTotal due amount
NamestringName of the validation error
MessagestringDescription of the validation error

Request JSON​

"statefilings/ct941wh/get?SubmissionId=01a0e708-6408-76cc-94a2-ea3dada33b43&RecordId=01a0e708-673c-716b-ac6d-bad8ee63096e"

Response JSON​

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

{
"SubmissionId": "01a0e708-6408-76cc-94a2-ea3dada33b43",
"StateWHRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e708-673c-716b-ac6d-bad8ee63096e",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "68f604f3-3ae4-4ffa-9e9e-8ad79de7ece4",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-9875855"
},
"BusinessNm": "Snowdaze LLC",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "B7D8CDBC-CFA4-402F-8367-1C09EF91FD2A",
"Address": {
"Address1": "123 Main St",
"Address2": "Suite 1001",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
}
},
"Address": {
"Address1": "123 Main St",
"Address2": "Suite 1001",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
},
"ContactDetails": {
"FirstNm": "James",
"MiddleNm": "A",
"LastNm": "Anderson",
"Suffix": "Jr",
"Phone": "(803) 555-1234",
"PhoneExtn": "101",
"Email": "contact@snowdaze.com",
"Fax": "(803) 555-5678"
},
"BusinessType": "ESTE",
"SigningAuthority": {
"FirstNm": "Ambrane",
"MiddleNm": "A",
"LastNm": "Cavil",
"Suffix": "Jr",
"Phone": "(803) 555-1000",
"PhoneExtn": "111",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": null,
"KindOfPayer": null
}
},
"ReturnData": {
"FormCT941": {
"WHIdNum": "64535450-000",
"IsNoPayroll": false,
"OperationCeasedDt": null,
"TotWages": "1000",
"TotCTWages": "500",
"TotTaxWH": "400",
"Overpayment": "500",
"TotTaxPaid": "100",
"TotPayment": "600",
"TotWHDue": "-200",
"Penalty": "0",
"Interest": "0",
"TotPenaltyInterest": "0",
"Credit": "200",
"Refund": "0",
"BalanceDue": "200",
"PayPeriod": [
{
"PayDate": "08/20/2025",
"Month1Amt": "400.00",
"Month2Amt": "0.00",
"Month3Amt": "0.00"
}
],
"TotMonth1TaxLiab": "400",
"TotMonth2TaxLiab": "0",
"TotMonth3TaxLiab": "0",
"TotTaxLiab": "400"
},
"StatePayment": {
"PaymentAmt": "200",
"BankRoutingNum": "217555555",
"BankAccountNum": "0000000001",
"AccountType": "Checking",
"PaymentReqDate": "12/31/2026"
},
"StateRefundAccount": {
"AccountType": "SAVING",
"BankRoutingNum": "017443944",
"BankAccountNum": "1279065890"
}
}
}
],
"Errors": null
}