Update
Update
Use this endpoint to update the information on existing 941ME forms that are already created for a specific employer (payer).
You cannot update a return once it has been transmitted.
POST StateFilings/ME941WH/Create Request Body
| Field | Type | Description |
|---|---|---|
| StateWHRecords | Object[] | Object to identify the records. |
| SequenceId | String | A unique identifier for this record. Size Range: ..50 |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form 941ME is to be filed. Allowed values2025,2026 |
| Qtr | String | The quarter for which the Form 941ME is to be filed.Allowed values"Q1", "Q2", "Q3", "Q4" |
| Business | Object | Object to identify the Business Details. |
| BusinessId | Guid | Optional Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again. |
| PayerRef | string | Optional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50 |
| 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.Allowed values"PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" — Pass tokenized TIN. |
| TINType | string | Specify the TIN type of the business.Allowed values"EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN" |
| TIN | string | The TIN value according to the Format selected. |
| IndividualNm | Object | Optional Required when TINType is SSN. Provide individual name fields instead of BusinessNm. |
| FirstNm | string | The first name of the individual. Size Range: 20 |
| MiddleNm | string | Optional Middle name of the individual. Size Range: 20 |
| LastNm | string | The last name of the individual. Size Range: 20 |
| Suffix | string | Optional Suffix of the individual's name.Allowed values"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII" |
| BusinessNm | string | Legal name of the business. Required when TINType is EIN. Size Range: 75 |
| NameCtrl | string | Name control of the business as registered with the IRS. Size Range: 3..4 |
| DBADetails | Object | Optional DBA (Doing Business As) information. |
| DBANm | string | Name of the DBA. Size Range: 75 |
| DBARef | string | Unique identifier for the DBA. Size Range: 1-50 |
| DBAId | Guid | TaxBandits-generated DBA identifier. |
| Address | Object | Address information of the DBA. |
| Address1 | string | Street address or PO Box. Size Range: 46 |
| Address2 | string | Optional Suite or apartment number. Size Range: 46 |
| City | string | DBA's city. Size Range: 50 |
| ProvinceOrState | string | DBA's province or state name. When the country code is US: Allowed values"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" Allowed values"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" |
| Zipcd | string | DBA's ZIP code. Size Range: 5-16 |
| Country | string | DBA's 2-character country code.Allowed values"US","AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI" |
| string | Optional Email address of the business. Size Range: ..100 | |
| Address | Object | Primary address of the business. |
| Address1 | string | Street address or PO Box of the business. Size Range: 46 |
| Address2 | string | Optional Suite or apartment number of the business. Size Range: 46 |
| City | string | City of the business. Size Range: 50 |
| ProvinceOrState | string | Province or state name of the business. When the country code is US: Allowed values"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" Allowed values"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" |
| ZipCd | string | ZIP code of the business. Size Range: 5-16 |
| Country | string | 2-character country code of the business.Allowed values"US","AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI" |
| ContactDetails | Object | Details of the person the IRS can contact regarding the given business. |
| FirstNm | string | First name of the contact person. Size Range: 20 |
| MiddleNm | string | Optional Middle name of the contact person. Size Range: 20 |
| LastNm | string | Last name of the contact person. Size Range: 20 |
| Suffix | string | Optional The suffix of the contact person.Allowed values"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII" |
| Phone | string | Optional Phone number of the contact person. Size Range: 10 digits |
| PhoneExtn | string | Optional Phone extension number. Size Range: 5 |
| string | Optional Email address of the contact person. Size Range: ..100 | |
| Fax | string | Optional Fax number of the contact person. Size Range: 10 digits |
| BusinessType | String | Legal structure of the business.Allowed values"ESTE", "PART", "CORP", "EORG", "SPRO", "SLGOV" |
| KindOfEmployer | String | Optional Indicates the kind of employer associated with the business, used for federal 941 reporting purposes. |
| KindOfPayer | String | Optional Indicates the kind of payer associated with the business, used for federal 941 reporting purposes. |
| SigningAuthority | Object | Details of the person authorized to sign the return. |
| FirstNm | String | First name of the signatory. Size Range: 20 |
| MiddleNm | String | Optional Middle name of the signatory. Size Range: 20 |
| LastNm | String | Last name of the signatory. Size Range: 20 |
| Suffix | String | Optional The suffix of the signatory.Allowed values"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII" |
| Phone | String | Optional Phone number of the signatory. Size Range: 10 digits |
| PhoneExtn | String | Optional Phone extension number of the signatory. Size Range: 5 |
| BusinessMemberType | String | Optional Title or role of the signatory.Allowed values"CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER", "REPORTINGAGENT" |
| ReturnData | Object | Contains the return information. |
| Form941ME | Object | Identifies the Form 941ME data. |
| WHIdNum | String | Maine withholding account number. Size Range: 9 - 8 digits plus hyphen |
| IsSch2Wavier | Boolean | When true, indicates that the entity is a non-wage withholder and has received written permission to exclude Schedule 2. |
| IsFinalReturn | Boolean | When true, indicates whether this is the entity's last return and want MRS to close the Maine income tax withholding account. |
| IsNoWageReported | Boolean | Optional When true, indicates that no wage is reported in this quarter. |
| DepositSchTyp | String | Indicates the type of Deposit schedule.Allowed values"SEMIWEEKLY", "QUARTERLY" |
| TotTaxWH | Number | Total amount of Maine income tax withheld. Size Range: 0-999999999999.99 |
| TotTaxPaid | Number | The total amount of semiweekly payments for the quarter. Size Range: 0-999999999.99 |
| TotWHDue | Number | The total amount due that is applicable with the return. Size Range: 0-999999999999.99 |
| Overpayment | Number | Optional The total amount that is to be refunded with this return. Size Range: 0-999999999999.99 |
| PayrollProcessorDetails | Object | Optional Identifies the information regarding the payroll processor details. |
| EIN | String | Enter the EIN of the payroll processor. Size Range: 9 |
| LicenseNum | String | Enter the Maine Payroll Processor License Number. Size Range: 7 |
| SemiWeeklyDepositor | Object | Optional Identifies the information regarding the semiweekly deposit schedule date and amount paid. |
| Month1PaymentDetails | Object[] | Identifies the information regarding the Month 1 payment details for the semiweekly deposit made. |
| PaymentDt | String | Enter the date on which payment was made in Month 1. Format: mmddyyyy |
| PaymentAmt | Number | Enter the amount deposited on the entered date for Month 1. Size Range: 0-9999999.99 |
| TotMonth1TaxLiab | Number | Total amount that was deposited in Month 1. Size Range: 0-999999999.99 |
| Month2PaymentDetails | Object[] | Identifies the information regarding the Month 2 payment details for the semiweekly deposit made. |
| PaymentDt | String | Enter the date on which payment was made in Month 2. Format: mmddyyyy |
| PaymentAmt | Number | Enter the amount deposited on the entered date for Month 2. Size Range: 0-9999999.99 |
| TotMonth2TaxLiab | Number | Total amount that was deposited in Month 2. Size Range: 0-999999999.99 |
| Month3PaymentDetails | Object[] | Identifies the information regarding the Month 3 payment details for the semiweekly deposit made. |
| PaymentDt | String | Enter the date on which payment was made in Month 3. Format: mmddyyyy |
| PaymentAmt | Number | Enter the amount deposited on the entered date for Month 3. Size Range: 0-9999999.99 |
| TotMonth3TaxLiab | Number | Total amount that was deposited in Month 3. Size Range: 0-999999999.99 |
| TotTaxLiab | Number | The total amount of semiweekly payments made for the quarter in Month 1, Month 2 and Month 3. Size Range: 0-999999999.99 |
| EmpDetails | Object[] | Object that contains information of the employees for the business. |
| EmployeeSequenceId | String | A unique reference ID for the submission that can be used to identify a particular employee. The Sequence ID will be returned in the Response for your reference. |
| EmployeeId | Guid | Optional A unique identifier generated by TaxBandits for an employee. You can use this ID for your future reference to Update. |
| EmployeeRef | String | Optional Your unique identifier for the Employee. Size Range: 1-50 |
| SSN | String | Enter the nine-digit SSN of the employee. Size Range: 9-11 digits |
| FirstNm | String | First Name of the employee. Size Range: ..20 |
| MiddleNm | String | Optional Middle Name of the employee. Size Range: ..20 |
| LastNm | String | Last Name of the employee. Size Range: ..20 |
| Suffix | String | Optional Suffix of the individual.Allowed values"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII" |
| Address | Object | Optional Address information of the employee. |
| Address1 | string | Street address of the employee. Size Range: 46 |
| Address2 | string | Optional Suite or apartment number of the employee. Size Range: 46 |
| City | string | City of the employee. Size Range: 50 |
| ProvinceOrState | string | Province or state name of the employee. Size Range: 50 |
| ZipCd | string | ZIP code of the employee. Size Range: 5-16 |
| Country | string | 2-character country code of the employee. |
| TaxWH | Number | Enter the total Maine income tax withheld for each payee who received wages or non-wage payments during the quarter. Size Range: 0-999999999999.99 |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier for a submission. |
| SuccessRecords | object[] | Provides detailed information about the success status of Form 941ME records. |
| SequenceId | string | A 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. |
| BusinessId | Guid | Unique identifier for the business (payer) generated by TaxBandits. |
| PayerRef | string | Unique identifier for the business (payer) provided by you. |
| RecordId | Guid | A unique identifier generated by TaxBandits when a 941ME return is created. |
| FormType | string | Denotes the type of withholding form (941ME). |
| EmployeeData | object[] | Object to identify the employee details. |
| EmployeeId | Guid | Returns the unique identifier of the employee generated by TaxBandits. |
| EmployeeRef | string | Returns your unique identifier for the employee. |
| Status | string | Returns the record status. |
| StatusTs | string | Returns the date and time when the return was created. |
| Info | string | Provides additional information about the return. |
| Errors | object[] | Displays error information related to the state returns of Form 941ME. |
| Id | string | Returns the validation error ID. |
| Name | string | Name of the validation error. |
| ErrorRecords | object[] | Provides detailed information about the error status of Form 941ME records. |
| SequenceId | string | A 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 for the record. |
| Errors | object[] | Displays 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": [
{
"SequenceId": "001",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": null,
"PayerRef": "",
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-0078766"
},
"BusinessNm": "Snowdaze LLC",
"NameCtrl": "SNOW",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": null,
"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,
"IsNoWageReported": false,
"DepositSchTyp": "SEMIWEEKLY",
"TotTaxWH": "22000.00",
"TotTaxPaid": "20000.00",
"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.00",
"Month2PaymentDetails": [
{
"PaymentDt": "08/23/2026",
"PaymentAmt": "5000.00"
},
{
"PaymentDt": "08/24/2026",
"PaymentAmt": "5000.00"
}
],
"TotMonth2TaxLiab": "10000.00",
"Month3PaymentDetails": [
{
"PaymentDt": "08/25/2026",
"PaymentAmt": "2000.00"
},
{
"PaymentDt": "08/26/2026",
"PaymentAmt": "2000.00"
}
],
"TotMonth3TaxLiab": "4000.00"
},
"TotTaxLiab": "20000.00",
"EmpDetails": [
{
"EmployeeSequenceId": "01",
"EmployeeId": null,
"EmployeeRef": "Pe011208121",
"SSN": "761-90-0091",
"FirstNm": "John",
"MiddleNm": "Joe",
"LastNm": "Smith",
"Suffix": "Jr",
"Address": {
"Address1": "19 Union Street",
"Address2": null,
"City": "Augusta",
"ProvinceOrState": "ME",
"ZipCd": "08330",
"Country": "US"
},
"TaxWH": "11000.00"
},
{
"EmployeeSequenceId": "02",
"EmployeeId": null,
"EmployeeRef": "Payee09801231011",
"SSN": "761-34-0990",
"FirstNm": "John",
"MiddleNm": "Joe",
"LastNm": "Smith",
"Suffix": "Jr",
"Address": {
"Address1": "19 Union Street",
"Address2": null,
"City": "Augusta",
"ProvinceOrState": "ME",
"ZipCd": "08330",
"Country": "US"
},
"TaxWH": "11000.00"
}
],
"TotWHAmt": "22000.00"
}
}
}
]
}
Response JSON
- 200
- 401
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "01a0e778-cbce-75fa-8eba-c729fa040ed4",
"SuccessRecords": [
{
"SequenceId": "001",
"BusinessId": "2e80edee-2105-4f8f-8037-43f7fb88c9f1",
"PayerRef": null,
"RecordId": "01a0e778-cd89-71bd-bcdc-94af348dbe1c",
"FormType": "ME941WH",
"EmployeeData": [
{
"EmployeeId": "e3719d08-df02-4a8a-92a9-d6c7154de917",
"EmployeeRef": "Pe011208121"
},
{
"EmployeeId": "a21168ef-871b-4d9f-a0f3-c70434a9ce0b",
"EmployeeRef": "Payee09801231011"
}
],
"Status": "CREATED",
"StatusTs": "2026-09-28 06:04:08 -04:00",
"Info": null,
"Errors": null
}
],
"ErrorRecords": null,
"Errors": null
}
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
{
"Errors": [
{
"Id": "AUTH-100018",
"Name": "Authorization",
"Message": "JWT EXPIRED"
}
]
}