Skip to main content
Version: 2.0.0

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.

POST StateFilings/ME941WH/Get 

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
RecordIdGuidAn unique identifier generated by TaxBandits when a 941ME return is created. Mention the return's Record ID that you want to get.

Response Body

FieldTypeDescription
SubmissionIdStringUnique identifier for the submission.
StateWHRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
RecordIdGuidA unique identifier generated by TaxBandits when a 941ME return is created.
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form 941ME is to be filed.
QtrStringThe quarter for which the Form 941ME 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.
PayerRefstringThe unique identifier for the payer.
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.
TINTypestringSpecify the TIN type of the business.
TINstringThe TIN value according to the Format selected.
BusinessNmstringLegal name of the business. Required when TINType is EIN.
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.
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.
BusinessTypeStringLegal structure of the business.
KindOfEmployerStringThe kind of employer associated with the business, used for federal 941 reporting purposes.
KindOfPayerStringThe kind of payer associated with the business, used for federal 941 reporting purposes.
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.
ReturnDataObjectIdentifies the Form 941ME data.
Form941MEObjectMaine Revenue Services Employer's Return of Maine Income Tax Withholding.
WHIdNumStringMaine withholding account number.
IsSch2WavierBooleanWhen true, indicates that the entity is a non-wage withholder and has received written permission to exclude Schedule 2.
IsFinalReturnBooleanWhen true, indicates whether this is the entity's last return and want MRS to close the Maine income tax withholding account.
IsNoWageRptdBooleanWhen true, indicates that no wage is reported in this quarter.
DepositSchTypStringType of Deposit schedule.
TotTaxWHNumberTotal amount of Maine income tax withheld.
TotTaxPaidNumberThe total amount of semiweekly payments for the quarter.
TotWHDueNumberThe total amount due that is applicable with the return.
OverpaymentNumberThe total amount that is to be refunded with this return.
PayrollProcessorDetailsObjectIdentifies the information regarding the payroll processor details.
EINStringEIN of the payroll processor.
LicenseNumStringMaine Payroll Processor License Number.
SemiWeeklyDepositorObjectIdentifies the information regarding the semiweekly deposit schedule date and amount paid.
Month1PaymentDetailsObject[]Identifies the information regarding the Month 1 payment details for the semiweekly deposit made.
PaymentDtStringDate on which payment was made in Month 1.
PaymentAmtNumberAmount deposited on the entered date for Month 1.
TotMonth1TaxLiabNumberTotal amount that was deposited in Month 1.
Month2PaymentDetailsObject[]Identifies the information regarding the Month 2 payment details for the semiweekly deposit made.
PaymentDtStringDate on which payment was made in Month 2.
PaymentAmtNumberAmount deposited on the entered date for Month 2.
TotMonth2TaxLiabNumberTotal amount that was deposited in Month 2.
Month3PaymentDetailsObject[]Identifies the information regarding the Month 3 payment details for the semiweekly deposit made.
PaymentDtStringDate on which payment was made in Month 3.
PaymentAmtNumberAmount deposited on the entered date for Month 3.
TotMonth3TaxLiabNumberTotal amount that was deposited in Month 3.
TotTaxLiabNumberThe total amount of semiweekly payments made for the quarter in Month 1, Month 2 and Month 3.
EmpDetailsObject[]Object that contains information of the employees for the business.
EmployeeSequenceIdStringA unique reference ID for the submission that can be used to identify a particular employee.
EmployeeIdGuidA unique identifier generated by TaxBandits for an employee.
EmployeeRefStringYour unique identifier for the Employee.
SSNStringSSN of the employee.
FirstNmStringFirst Name of the employee.
MiddleNmStringMiddle Name of the employee.
LastNmStringLast Name of the employee.
SuffixStringSuffix of the individual.
AddressObjectAddress information of the employee.
Address1stringStreet address of the employee.
Address2stringSuite or apartment number of the employee.
CitystringCity of the employee.
ProvinceOrStatestringProvince or state name of the employee.
ZipCdstringZIP code of the employee.
Countrystring2-character country code of the employee.
TaxWHNumberTotal Maine income tax withheld for each payee who received wages or non-wage payments during the quarter.
Errorsobject[]Shows detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

"statefilings/me941wh/Get?SubmissionId=01a0e778-cbce-75fa-8eba-c729fa040ed4&RecordId=01a0e778-cd89-71bd-bcdc-94af348dbe1c"

Response JSON​

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

{
"SubmissionId": "01a0e778-cbce-75fa-8eba-c729fa040ed4",
"StateWHRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e778-cd89-71bd-bcdc-94af348dbe1c",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "2e80edee-2105-4f8f-8037-43f7fb88c9f1",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-0078766"
},
"BusinessNm": "Snowdaze LLC",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "E9FD3488-68A4-465D-BCBD-135D710CBBBC",
"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": "8085551234",
"PhoneExtn": "101",
"Email": "contact@snowdaze.com",
"Fax": "8085555678"
},
"BusinessType": "ESTE",
"SigningAuthority": {
"FirstNm": "Ambrane",
"MiddleNm": "A",
"LastNm": "Cavil",
"Suffix": "Jr",
"Phone": "8085551000",
"PhoneExtn": "111",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": "FEDERALGOVT",
"KindOfPayer": "REGULAR941"
}
},
"ReturnData": {
"Form941ME": {
"WHIdNum": "5264-5678",
"IsSch2Wavier": false,
"IsFinalReturn": false,
"IsNoWageRptd": false,
"DepositSchTyp": "SEMIWEEKLY",
"TotTaxWH": 22000,
"TotTaxPaid": 20000,
"TotWHDue": 2000,
"Overpayment": 0,
"PayrollProcessorDetails": {
"EIN": "74-5548906",
"LicenseNum": "4561554"
},
"SemiWeeklyDepositor": {
"Month1PaymentDetails": [
{
"PaymentDt": "08/21/2026",
"PaymentAmt": "5000.00"
},
{
"PaymentDt": "08/22/2026",
"PaymentAmt": "1000.00"
}
],
"TotMonth1TaxLiab": 6000,
"Month2PaymentDetails": [
{
"PaymentDt": "08/23/2026",
"PaymentAmt": "5000.00"
},
{
"PaymentDt": "08/24/2026",
"PaymentAmt": "5000.00"
}
],
"TotMonth2TaxLiab": 10000,
"Month3PaymentDetails": [
{
"PaymentDt": "08/25/2026",
"PaymentAmt": "2000.00"
},
{
"PaymentDt": "08/26/2026",
"PaymentAmt": "2000.00"
}
],
"TotMonth3TaxLiab": 4000
},
"TotTaxLiab": 20000,
"EmpDetails": [
{
"EmployeeSequenceId": "01",
"EmployeeId": "e3719d08-df02-4a8a-92a9-d6c7154de917",
"EmployeeRef": "Pe011208121",
"SSN": "761-90-0091",
"FirstNm": "John",
"MiddleNm": "Joe",
"LastNm": "Smith",
"Suffix": "Jr",
"TaxWH": 11000,
"Address": {
"Address1": "19 Union Street",
"Address2": null,
"City": "Augusta",
"ProvinceOrState": "ME",
"ZipCd": "08330",
"Country": "US"
}
},
{
"EmployeeSequenceId": "02",
"EmployeeId": "a21168ef-871b-4d9f-a0f3-c70434a9ce0b",
"EmployeeRef": "Payee09801231011",
"SSN": "761-34-0990",
"FirstNm": "John",
"MiddleNm": "Joe",
"LastNm": "Smith",
"Suffix": "Jr",
"TaxWH": 11000,
"Address": {
"Address1": "19 Union Street",
"Address2": null,
"City": "Augusta",
"ProvinceOrState": "ME",
"ZipCd": "08330",
"Country": "US"
}
}
],
"TotWHAmt": 22000
}
}
}
],
"Errors": null
}