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
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. |
| RecordId | Guid | An 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
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. Not required |
| StateWHRecords | Object[] | Object to identify the records. |
| SequenceId | String | A unique identifier for this record. |
| RecordId | Guid | A unique identifier generated by TaxBandits when a Form CT-941 return is created. |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form CT-941 is to be filed. |
| Qtr | String | The quarter for which the Form CT-941 is to be filed. |
| Business | object | Object to identify the Business Details. |
| BusinessId | Guid | The unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. |
| PayerRef | string | Unique identifier for the payer. Can replace BusinessId in future requests. |
| IsDefaultBusiness | Boolean | When set to TRUE, this business will be set as the default across requests that do not specify a business. |
| TINDetails | object | TIN information for the business. |
| Format | string | Specifies how the TIN is passed. |
| TINType | string | The TIN type of the business. |
| TIN | string | The TIN value according to the Format selected. |
| IndividualNm | object | Required when TINType is SSN. Provide individual name fields instead of BusinessNm. |
| FirstNm | string | The first name of the individual. |
| MiddleNm | string | Middle name of the individual. |
| LastNm | string | The last name of the individual. |
| Suffix | string | Suffix of the individual's name. |
| BusinessNm | string | Legal name of the business. |
| NameCtrl | string | Name control of the business as registered with the IRS. |
| DBADetails | object[] | DBA (Doing Business As) information. |
| DBANm | string | Name of the DBA. |
| DBARef | string | Unique identifier for the DBA. |
| DBAId | Guid | TaxBandits-generated DBA identifier. |
| Address | object[] | Address information of the DBA. |
| Address1 | string | Street address or PO Box. |
| Address2 | string | Suite or apartment number. |
| City | string | DBA's city. |
| ProvinceOrState | string | DBA's province or state name. |
| Zipcd | string | DBA's ZIP code. |
| Country | string | DBA's 2-character country code. |
| string | Email address of the Business. | |
| Address | object | Primary address of the business. |
| Address1 | string | Street address or PO Box of the business. |
| Address2 | string | Suite or apartment number of the business. |
| City | string | City of the business. |
| ProvinceOrState | string | Province or state name of the business. |
| ZipCd | string | ZIP code of the business. |
| Country | string | 2-character country code of the business. |
| ContactDetails | object[] | Details of the person the IRS can contact regarding the given business. |
| FirstNm | string | First name of the contact person. |
| MiddleNm | string | Middle name of the contact person. |
| LastNm | string | Last name of the contact person. |
| Suffix | string | The suffix of the contact person. |
| Phone | string | Phone number of the contact person. |
| PhoneExtn | string | Phone extension number. |
| string | Email address of the contact person. | |
| Fax | string | Fax number of the contact person. |
| SigningAuthority | Object | Details of the person authorized to sign the return. |
| FirstNm | String | First name of the signatory. |
| MiddleNm | String | Middle name of the signatory. |
| LastNm | String | Last name of the signatory. |
| Suffix | String | The suffix of the signatory. |
| Phone | String | Phone number of the signatory. |
| PhoneExtn | String | Phone extension number of the signatory. |
| BusinessMemberType | String | Title or role of the signatory. |
| ReturnData | Object[] | Identifies the Form CT-941 data. |
| FormCT941 | Object | Connecticut withholding tax return. |
| WHIdNum | String | Connecticut withholding ID number. |
| IsFinalReturn | Boolean | If true identifies that the payer no longer has any employees and no payroll has been carried forward. |
| OperationCeasedDt | String | Date when the last payroll was processed. |
| TotWages | Number | Gross wages paid for the quarter. |
| TotCTWages | Number | Gross wages paid, subject to Connecticut withholding, for the quarter. |
| TotTaxWH | Number | Connecticut tax withheld for the quarter. |
| Overpayment | Number | Overpayment Credit from prior quarter. |
| TotTaxPaid | Number | Payments made for this quarter. |
| TotPayment | Number | Total payments from tax withheld and overpayment Credit from prior quarter. |
| TotWHDue | Number | Net tax due for the quarter. |
| Penalty | Number | Penalty for the quarter. |
| Interest | Number | Interest due for the quarter. |
| TotPenaltyInterest | Number | Total penalties and interest due amount. |
| Credit | Number | Amount to be credited. |
| Refund | Number | Amount to be refunded. |
| BalanceDue | Number | Total tax amount due. |
| PayPeriod | Object[] | Object that contains tax liability details for the quarter. |
| PayDate | String | Date when the payment was made. |
| Month1Amt | Number | Liability amount for first month of the quarter. |
| Month2Amt | Number | Liability amount for second month of the quarter. |
| Month3Amt | Number | Liability amount for third month of the quarter. |
| TotMonth1TaxLiab | Number | Total tax liability for the first month of the quarter. |
| TotMonth2TaxLiab | Number | Total tax liability for the second month of the quarter. |
| TotMonth3TaxLiab | Number | Total tax liability for the third month of the quarter. |
| TotTaxLiab | Number | Total tax liability for the quarter. |
| StatePayment | Object | Object that contains information about the payment details. |
| PaymentAmt | Number | Amount to be paid. |
| BankRoutingNum | string | Bank Routing Number of payment. |
| BankAccountNum | string | Bank Account Number for payment. |
| AccountType | string | Bank account type. Allowed values"Checking", "Saving" |
| PaymentReqDate | String | Date when the payment has to be made. |
| StateRefundAccount | Object | Object that contains information about the refund account details. |
| AccountType | string | Bank account type. Allowed values"Checking", "Saving" |
| BankRoutingNum | string | Bank Routing Number of payment. |
| BankAccountNum | string | Bank Account Number for payment. |
| IsForeignBankAcc | Boolean | If true identifies that provided account details belong to a foreign account. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error ID. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
"statefilings/ct941wh/Get?SubmissionId=01a0e708-6408-76cc-94a2-ea3dada33b43&RecordId=01a0e708-673c-716b-ac6d-bad8ee63096e"
Response JSON
- 200
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
}