Create
Create
Use this endpoint to create a Form CT-941 (Connecticut Quarterly Reconciliation of Withholding) for an employer (payer). This return reports:
- Total wages paid
- Connecticut income tax withheld
- Quarterly withholding liability details
Note:
Employers are required to file Form CT-941 for each quarter, even if no taxes were withheld.
POST StateFilings/CT941WH/Create Request Body
| Field | Type | Description |
|---|---|---|
| StateWHRecords | Object[] | Object to create CT-941 |
| SequenceId | String | A unique number given by an inbound application to identify failed records. Size Range: ..10 |
| ReturnHeader | Object | Identifies the supporting details of Form CT-941. |
| Qtr | String | The Quarter for which Form CT-941 needs to be filed.Allowed values"Q1", "Q2", "Q3", "Q4" |
| TaxYr | String | The tax year for which Form CT-941 needs to be filed.Allowed values"2025", "2026" |
| BusinessId | String | Optional Use the unique BusinessId (Generated by TaxBandits) you receivedin the response of the Business CREATE Endpoint. If you do not have aBusinesId, ignore the field. By giving the BusinessId, you do not have to provide all the business information again. |
| Business | Object | The details of the business you’re filing for. |
| BusinessNm | String | Name of the business. Size Range: ..75 |
| PayerRef | string | Optional An unique identifier for each payer completing their information.This identifier can be used in future references of the payer in the API. Size Range: ..50 |
| TradeNm | String | Optional Name under which the business operates. Size Range: ..75 |
| IsEIN | Boolean | When true, identifies the business with an EIN. |
| EINorSSN | String | When IsEIN is true, use Employer Identification Number (EIN). When IsEIN isfalse, use Social Security Number (SSN). Size Range: 9-11 |
| String | Email address of the business. Size Range: ..100 | |
| IsForeign | Boolean | When true, identifies the business as having a foreign address. |
| USAddress | Object | If IsForeign is false, pass the US address of the business. |
| Address1 | String | Employer/Payer’s US address (street address or post office box). Size Range: ..46 |
| Address2 | String | Optional Employer/Payer’s suite or apartment. Size Range: ..46 |
| City | String | Employer/Payer’s city. Size Range: ..50 |
| State | String | Employer/Payer’s state. Size Range: 2 Allowed valuesAL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL","GA", "HI","ID", "IL", "IN", etc. |
| ZipCd | String | Employer/Payer’s zip code. Size Range: 5..10 |
| ForeignAddress | Object | If IsForeign is true, pass the foreign address of the business. |
| Address1 | String | Employer/Payer’s foreign address (street address or post office box). Size Range: ..50 |
| Address2 | String | Optional Employer/Payer’s suite or apartment. Size Range: ..50 |
| City | String | Employer/Payer’s city. Size Range: ..50 |
| ProvinceOrStateNm | String | Employer/Payer’s province or state name. Size Range: ..50 |
| Country | String | Employer/Payer’s country. Size Range: 2 Allowed values"AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC","AR", "AM","AA", "AT", "AS", etc. |
| PostalCd | String | Employer/Payer’s postal code. Size Range: ..16 |
| ReturnData | Object[] | Identifies the Form CT-941 data. |
| WHIdNum | String | Connecticut withholding ID number. Size Range: ..13 |
| IsNoPayroll | Boolean | If true identifies that the payer no longer has any employees and no payroll has been carried forward. |
| LastPayrollDt | String | Date when the last payroll was processedEnter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025). |
| L1GrossWagesAmt | Number | Gross wages paid for the quarter Size Range: 0-9999999999.99 |
| L2GrossCTWagesAmt | Number | Gross wages paid subject to Connecticut withholding for the quarter Size Range: 0-9999999999.99 |
| L3TaxWH | Number | Connecticut tax withheld for the quarter Size Range: 0-9999999999.99 |
| L4Overpayment | Number | Overpayment Credit from prior quarter Size Range: 0-9999999999.99 |
| L5TaxPaid | Number | Payments made for this quarter Size Range: 0-9999999999.99 |
| L6TotPayAmt | Number | Total payments from tax withheld and overpayment Credit from prior quarter Size Range: 0-9999999999.99 |
| L7TaxDue | Number | Net tax due for the quarter *Size Range: -9999999999.99 to 9999999999.99Note:If this amount is a negative number, use a minus sign |
| L8aPenalty | Number | Penalty for the quarter Size Range: 0-9999999999.99 |
| L8bInterest | Number | Interest due for the quarter Size Range: 0-9999999999.99 |
| L8TotPenIntAmt | Number | Total penalties and interest due amount Size Range: 0-9999999999.99 |
| L9CreditAmt | Number | Amount to be credited Size Range: 0-9999999999.99 |
| L10RefundAmt | Number | Amount to be refunded Size Range: 0-9999999999.99 |
| L11TotAmtDue | Number | Total tax amount due Size Range: 0-9999999999.99 |
| PayPeriod | Object [] | Object that contains tax liability details for the quarter |
| PayDate | String | Date when the payment was made.Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025). |
| Month1Amt | Number | Liability amount for first month of the quarter Size Range: 0-9999999999.99 |
| Month2Amt | Number | Liability amount for second month of the quarter Size Range: 0-9999999999.99 |
| Month3Amt | Number | Liability amount for third month of the quarter Size Range: 0-9999999999.99 |
| Month1TotTaxLiability | Number | Total tax liability for the first month of the quarter Size Range: 0-9999999999.99 |
| Month2TotTaxLiability | Number | Total tax liability for the second month of the quarter Size Range: 0-9999999999.99 |
| Month3TotTaxLiability | Number | Total tax liability for the second month of the quarter Size Range: 0-9999999999.99 |
| TotTaxLiabilityAmt | Number | Total tax liability for the quarter Size Range: 0-9999999999.99 |
| StatePayment | Object | Object that contains information about the payment details |
| PaymentAmt | Number | Amount to be paid Size Range: 0-9999999999.99 |
| BankRoutingNum | string | Bank Routing Number of payment Size Range: 9 |
| BankAccountNum | string | Bank Account Number for payment Size Range: ..17 |
| AccountType | string | Bank account typeAllowed values"Checking" , "Saving" |
| PaymentReqDate | String | Date when the payment has to be made.Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025). |
| StateRefundAccount | Object | Object that contains information about the refund account details |
| AccountType | string | Bank account typeAllowed values"Checking" , "Saving" |
| BankRoutingNum | string | Bank Routing Number of payment Size Range: 9 |
| BankAccountNum | string | Bank Account Number for payment Size Range: ..17 |
| IsForeignBankAcc | Boolean | If true identifies that provided account details belong to a foreign account. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form CT-941 Records |
| SequenceId | string | Returns the unique reference ID for the submission that can be used to identify a particular record |
| BusinessId | Guid | Unique identifier of a Business |
| PayerRef | string | Unique identifier of the payer |
| RecordId | Guid | An unique identifier generated by TaxBandits when a CT-941 return is created |
| FormType | string | Denotes the type of withholding form (Form CT-941). |
| Status | string | Returns the record status of return. |
| StatusTs | string | Date and time of the return created. |
| Info | string | Returns the information about the return |
| Errors | object[] | Shows error information of state returns of Form CT-941 |
| Id | string | Returns the validation error Id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
| ErrorRecords | object[] | It will show the detailed information about the error status of Form CT-941 Records. |
| SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
| RecordId | Guid | Unique identifier of a record |
| 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 |
| 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
{
"StateWHRecords": [
{
"Sequence": "001",
"ReturnHeader": {
"Qtr": "Q4",
"TaxYr": "2025",
"Business": {
"BusinessNm": "Snowdaze LLC",
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"PayerRef": "snoqq2223",
"TradeNm": "Iceberg Icecreams",
"IsDefaultBusiness": true,
"IsEIN": true,
"EINorSSN": "23-3875475",
"Email": "james@sample.com",
"ContactNm": "James Smith",
"Phone": "6534567890",
"PhoneExtn": "123",
"Fax": "9834567890",
"BusinessType": "ESTE",
"SigningAuthority": {
"Name": "James Smith",
"Phone": "9934567890",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": "FEDERALGOVT",
"KindOfPayer": "REGULAR941",
"IsBusinessTerminated": false,
"Form1042SDetails": {
"WHAgtCh3Cd": "11",
"WHAgtCh4Cd": "16",
"WHAgtGIIN": null,
"FTIN": "12345",
"Country": "AL"
},
"IsForeign": false,
"USAddress": {
"Address1": "3576 AIRPORT WAY",
"Address2": "UNIT 9",
"City": "FAIRBANKS",
"State": "AK",
"ZipCd": "99709"
},
"ForeignAddress": null,
"ACADetails": null
}
},
"ReturnData": {
"FormCT941": {
"WHIdNum": "6457354575-354",
"IsNoPayroll": false,
"LastPayrollDt": "12/21/2025",
"L1GrossWagesAmt": "1000.00",
"L2GrossCTWagesAmt": "500.00",
"L3TaxWH": "400.00",
"L4Overpayment": "500.00",
"L5TaxPaid": "0.00",
"L6TotPayAmt": "500.00",
"L7TaxDue": "-100.00",
"L8aPenalty": "0.00",
"L8bInterest": "0.00",
"L8TotPenIntAmt": "0.00",
"L9CreditAmt": "100.00",
"L10RefundAmt": "0.00",
"L11TotAmtDue": "100.00",
"PayPeriod": [
{
"PayDate": "08/20/2025",
"Month1Amt": "400.00",
"Month2Amt": "0.00",
"Month3Amt": "0.00"
}
],
"Month1TotTaxLiability": "400.00",
"Month2TotTaxLiability": "0.00",
"Month3TotTaxLiability": "0.00",
"TotTaxLiabilityAmt": "400"
},
"StatePayment": {
"PaymentAmt": "100.00",
"BankRoutingNum": "217555555",
"BankAccountNum": "0000000001",
"AccountType": "Checking",
"PaymentReqDate": "12/31/2026"
},
"StateRefundAccount": {
"AccountType": "CHECKING",
"BankRoutingNum": "867443944",
"BankAccountNum": "934784433",
"IsForeignBankAcc": false
}
}
}
]
}
Response JSON
- 200
Success Response - This is a sample response for successful API requests.
{
"StatusCode": "200",
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "019d1a68-e397-754b-ab1c-4c2edc8876ec",
"SuccessRecords": [
{
"SequenceId": "001",
"BusinessId": "2fa5381e-8c36-4fbd-8d66-8b0db29d3d90",
"PayerRef": "bdfjjghghdhgfh",
"RecordId": "019d1a68-fa42-753f-8b18-5d3b60fa6d1f",
"FormType": "CT941WH",
"Status": "CREATED",
"StatusTs": "2026-03-23 16:46:20 +05:30",
"Info": null,
"Errors": null
}
],
"ErrorRecords": null,
"Errors": null
}