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
StateWHRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
RecordIdGuidA unique identifier generated by TaxBandits when a Form CT-941 return is created.
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.
MiddleNmstringMiddle 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 third 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.
Allowed values

"Checking", "Saving"

PaymentReqDateStringDate when the payment has to be made.
StateRefundAccountObjectObject that contains information about the refund account details.
AccountTypestringBank account type.
Allowed values

"Checking", "Saving"

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.
IdstringReturns the validation error ID.
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
}