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 forms.
GET StateFilings/CT941WH/Get Request Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a 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. |
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. Not required when you are creating a return. |
| 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. |
| Errors | object[] | Shows detailed error information |
| Id | string | Total due amount Size Range: 0-99999999.99 |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
Request Params
"statefilings/CT941WH/Get?RecordId=f5c0b155-7261-4f9d-b0bc-cad7a0f69d2e&SubmissionId=01993c45-e77e-7383-823a-d13273fd717c"
Response JSON
- 200
- 400
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",
"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
}
}
}
],
"Errors": null
}
Bad Request Response - You'll get the below response when your API requests contain any validation errors.
{
"StatusCode": "400",
"StatusName": "BadRequest",
"StatusMessage": "Validation error has occurred",
"SubmissionId": null,
"StateUIRecords": null,
"Errors": [
{
"Id": "S00-000099",
"Name": "RecordId",
"Message": "RecordId is invalid."
}
]
}