Get

Get

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

GET StateFilings/MAWH/Get 

Run in Postman

Request Params

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
RecordId	Guid	An unique identifier generated by TaxBandits when a WTH-10001 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 when you are creating a return.
StateWHRecords	Object[]	Object to create M-941
SequenceId	String	A unique number given by an inbound application to identify failed records.
ReturnHeader	Object	Identifies the supporting details of Form M-941.
Qtr	String	The Quarter for which Form M-941 needs to be filed.
TaxYr	String	The tax year for which Form M-941 needs to be filed.
BusinessId	String	Use the unique BusinessId (Generated by TaxBandits) you received in the response of the Business CREATE Endpoint. If you do not have a BusinessId, 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.
PayerRef	string	A unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API.
TradeNm	String	Name under which the business operates.
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	String	When IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN).
Email	String	Email address of the business.
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).
Address2	String	Employer/Payer's suite or apartment.
City	String	Employer/Payer's city.
State	String	Employer/Payer's state.
ZipCd	String	Employer/Payer's zip code.
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).
Address2	String	Employer/Payer's suite or apartment.
City	String	Employer/Payer's city.
ProvinceOrStateNm	String	Employer/Payer's province or state name.
Country	String	Employer/Payer's country.
PostalCd	String	Employer/Payer's postal code.
ReturnData	Object[]	Identifies the Form M-941 data.
FormM941	Object	Massachusetts withholding tax returns.
WHIdNum	String	Massachusetts withholding file number.
FilingFrequency	string	Filing frequency of the Form M-941
Month	string	Select the month for the monthly filing period.
IsFinalReturn	Boolean	When true, indicates that it is a final return
NumOfEmployees	Number	Number of employees.
WHAmt	Number	Massachusetts income tax withheld from all sources for the filing period
IsTaxPaid	Boolean	When true, identifies that the employer has made previous payments.
TaxPaidDetails	Object[]	Identifies the tax paid details.
Date	string	The date the tax was paid. Format: MM/DD/YYYY or MM-DD-YYYY
Amount	string	Tax paid on the date mentioned
TaxPaid	Number	Total tax paid for the filing period
PrevCrdtAmt	Number	Previous credits payments made for the filing period
TotTaxPaid	Number	Total payments and credits.
TotTaxDue	Number	Total tax due.
Penalty	Number	Total penalty amount
Interest	Number	Total interest due amount
TotBalanceDue	Number	Total due amount
OverPaymentRecoveryType	string	The overpayment recovery type.
StatePayment	Object	Object that contains information about the payment details
AccountType	string	Bank account type
BankNm	string	Bank account name of payment
BankRoutingNum	string	Bank Routing Number of payment
BankAccountNum	string	Bank Account Number for payment
PaymentAmt	Number	Amount to be paid
PaymentReqDate	String	Date when the payment has to be made.
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 Params

"statefilings/MAWH/get?SubmissionId=019db3c1-8275-71c4-8899-4f3ec8dff392"

Response JSON

200

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019dcdb8-1cc6-7168-ba3d-040d9e99121b",
  "StateWHRecords": [
      {
          "SequenceId": "001",
          "RecordId": "019dcdb8-1dd8-7087-9baa-cd677b556eed",
          "ReturnHeader": {
              "Qtr": "",
              "TaxYr": "2025",
              "Business": {
                  "BusinessId": "01f83dd9-6f9d-4ed4-a7ee-ec67a6f8d222",
                  "BusinessNm": "Snowdaze LLC",
                  "PayerRef": null,
                  "FirstNm": null,
                  "MiddleNm": null,
                  "LastNm": null,
                  "Suffix": null,
                  "TradeNm": "Mayfill Tech",
                  "IsEIN": true,
                  "EINorSSN": "74-5985016",
                  "Email": "james@sample.com",
                  "ContactNm": "John",
                  "Phone": "(789) 456-1231",
                  "PhoneExtn": null,
                  "Fax": null,
                  "BusinessType": "ESTE",
                  "SigningAuthority": {
                      "Name": "John",
                      "Phone": "(789) 789-7987",
                      "BusinessMemberType": "ADMINISTRATOR"
                  },
                  "KindOfEmployer": null,
                  "KindOfPayer": null,
                  "IsBusinessTerminated": false,
                  "IsForeign": false,
                  "USAddress": {
                      "Address1": "12 Main St",
                      "Address2": "Apt 2B",
                      "City": "Boston",
                      "State": "MA",
                      "ZipCd": "02108"
                  },
                  "ForeignAddress": null,
                  "ACADetails": null
              }
          },
          "ReturnData": {
              "FormM941": {
                  "WHIdNum": "WTH-74598501-001",
                  "FilingFrequency": "MONTHLY",
                  "Month": "NOV",
                  "IsFinalReturn": false,
                  "NumOfEmployees": "20",
                  "WHAmt": 200,
                  "IsTaxPaid": true,
                  "TaxPaidDetails": [
                      {
                          "Date": "11/21/2025",
                          "Amount": 60
                      },
                      {
                          "Date": "11/05/2025",
                          "Amount": 60
                      }
                  ],
                  "TaxPaid": 120,
                  "PrevCrdtAmt": 60,
                  "TotTaxPaid": 180,
                  "TotTaxDue": 20,
                  "Penalty": 0,
                  "Interest": 0,
                  "TotBalanceDue": 20,
                  "OverPaymentRecoveryType": null
              },
              "StatePayment": {
                  "AccountType": "PERSONAL_CHECKING",
                  "BankNm": "IFB",
                  "BankRoutingNum": "021000021",
                  "BankAccountNum": "00133",
                  "PaymentAmt": 100,
                  "PaymentReqDate": "11/25/2025"
              }
          }
      }
  ],
  "Errors": null
}

400

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."
      }
  ]
}