Version: 1.7.3

Create

POST StateFilings/ME941WH/Create

Run in Postman

Request Body

Field	Type	Description
StateWHRecords	Object[]	Object to create 941MEs
SequenceId	String	A unique number given by an inbound application to identify failed records. Size Range: ..50
ReturnHeader	Object	Identifies the supporting details of Form 941ME.
Qtr	String	The Quarter for which Form 941ME needs to be filed. Allowed values "Q1", "Q2", "Q3", "Q4"
TaxYr	String	The tax year for which Form 941ME needs to be filed. Allowed values 2025, 2026
Business	Object	Object to identify the business details.
BusinessId	Guid	Optional Use the unique identifier provided in the response from the Business CREATE endpoint.
BusinessNm	String	Name of the business. Size Range: ..75
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 the Employer Identification Number (EIN) Note: IsEIN should always be set to true, as EIN is the only allowed TIN type for state payroll forms. Size Range: 9-11
Email	String	Optional Email address of the business. Size Range: ..100
ContactNm	String	Optional Name of the person who can be contacted by the State Agency. Size Range: ..27
Phone	String	Optional Phone number of the business. Size Range: 10
PhoneExtn	String	Optional Extension of the business phone number. Size Range: ..5
Fax	String	Optional Fax number of the business. Size Range: 10
BusinessType	String	Type of business. Size Range: 5 Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO", "SLGOV"
SigningAuthority	Object	Details of the person who is authorized to sign the return.
Name	String	Name of the signing authority. Size Range: ..35
Phone	String	Phone number of the signing authority. Size Range: 10
BusinessMemberType	String	Business title of the signing authority Size Range: 5..29 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"
KindOfEmployer	String	Optional Identifies the kind of employer. Allowed values "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	String	Optional Identifies the kind of payer. Allowed values "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, indicates that the business is terminated.
IsForeign	Object	When true, indicates that the business has a foreign address.
USAddress	Object	If IsForeign is false, pass the US address of the business.
Address1	String	Employer/Payer's US address (street or post office box of that locality). 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 code. Refer to static values. Size Range: 2 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"
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 of that locality). 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", "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"
PostalCd	String	Employer/Payer's postal code. Size Range: ..16
ReturnData	Object[]	Identifies the Form 941ME data.
Form941ME	Object	Maine Revenue Services Employer's Return of Maine Income Tax Withholding
WHIdNum	String	North Carolina 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.
DepositSchedule	String	Indicates the type of Deposit schedule Allowed values "SEMIWEEKLY", "QUARTERLY"
TotTaxWH	String	Total amount of Maine income tax withheld. Size range: 999999999999.99
TaxPaid	String	The total amount of semiweekly payments for the quarter. Size range: 999999999.99
BalanceDue	String	The total amount due that is applicable with the return. Size range: 999999999999.99
Overpayment	String	The total amount that is to be refunded with this return. Size range: 999999999999.99
PayrollProcessorDetails	Object	Object 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	Object Identifies the information regarding the Semiweekly deposit schedule date and amount paid
Month1PaymentDetails	Object[]	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 Month1. Format: mmddyyyy
PaymentAmt	String	Enter the amount deposited on the entered date for Month 1. Size range: 9999999.99
Month1TotTaxLiability	String	Total amount that was deposited in the Month 1. Size range: 999999999.99
Month2PaymentDetails	Object[]	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	String	Enter the amount deposited on the entered date for Month 2. Size range: 9999999.99
Month2TotTaxLiability	String	Total amount that was deposited in the Month 2. Size range: 999999999.99
Month3PaymentDetails	Object[]	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	String	Enter the amount deposited on the entered date for Month 3. Size range: 9999999.99
Month3TotTaxLiability	String	Total amount that was deposited in the Month 3. Size range: 999999999.99
TotQtrTaxLiabilityAmt	String	The total amount of semiweekly payments made for the quarter in Month 1, Month 2 and Month 3. Size range: 999999999.99
EmpDetails	Object	Object that contains information of the employees for the business.
EmpSequenceId	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.
EmpId	Guid	A unique identifier generated by TaxBandits for an employee. You can use this ID for your future reference to Update.
EmpRefSSN	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	Middle Name of the employee. Size Range: ..20
LastNm	String	Last Name of the employee. Size Range: ..20
Suffix	String	Suffix of the Individual. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
USAddress	Object	US address of the employee.
Address1	String	Address of the Employee (street address or post office box of that locality). Size Range: ..46
Address2	String	Optional Suite or apartment number of the Employee. Size Range: ..46
City	String	City where the Employer/Payer is based out of. Size Range: ..50
State	String	Name of the state where the Employee is based out of. Size Range: 2 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"
ZipCd	String	Zip Code the State where the Employee is based out of. Size Range: 5..10
TaxWH	String	Enter the total Maine income tax withheld for each payee who received wages or non-wage payments during the quarter. Size range: 999999999999.99
TotWHAmt	String	The total Maine income tax withheld for all the Employee listed. Size range: 999999999999.99

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 941ME Records
SequenceId	string	A unique number given by an inbound application to identify particular records.
BusinessId	Guid	Unique identifier of a Business
PayerRef	string	Unique identifier of the payer
RecordId	Guid	A unique identifier generated by TaxBandits when a 941ME return is created
FormType	string	Denotes the type of withholding form (941ME).
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 941ME.
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 941ME Records.
SequenceId	string	A unique number given by an inbound application to identify particular records. 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

Request JSON

{
    "StateWHRecords": [
        {
            "SequenceId": "001",
            "ReturnHeader": {
                "Qtr": "Q1",
                "TaxYr": "2025",
                "Business": {
                    "BusinessNm": "Snowdaze LLC",
                    "TradeNm": "Mayfill Tech",
                    "IsEIN": true,
                    "EINorSSN": "74-5985016",
                    "Email": "james@sample.com",
                    "ContactNm": "John",
                    "Phone": "7894561231",
                    "IsForeign": false,
                    "BusinessType": "ESTE",
                    "SigningAuthority": {
                        "Name": "John",
                        "Phone": "3231231232",
                        "BusinessMemberType": "OWNER"
                    },
                    "USAddress": {
                        "Address1": "19 Union Street",
                        "Address2": null,
                        "City": "Augusta",
                        "State": "ME",
                        "ZipCd": "04330"
                    },
                    "ForeignAddress": {
                        "Address1": null,
                        "Address2": null,
                        "City": null,
                        "ProvinceOrStateNm": null,
                        "Country": null,
                        "PostalCd": null
                    }
                }
            },
            "ReturnData": {
                "Form941ME": {
                    "WHIdNum": "1234-5678",
                    "IsSch2Wavier": false,
                    "IsFinalReturn": false,
                    "DepositSchedule": “SEMIWEEKLY”,
                    "TotTaxWH": "200.00",
                    "TaxPaid": "200.00",
                    "BalanceDue": "200.00",
                    "Overpayment": "100.00",
                    "PayrollProcessorDetails":{
                      "EIN": "74-5985016",
                      "LicenseNum": "1234567"
                    },
                    "SemiWeeklyDepositor": {
                      "Month1PaymentDetails": [
                        {
                          "PaymentDt": "03/21/2026",
                          "PaymentAmt": "2000.00"
                          
                        },
                        {
                          "PaymentDt": "03/21/2026",
                          "PaymentAmt": "2000.00"
                        }
                        ],
                        "Month1TotTaxLiability": "500.00",
                        "Month2PaymentDetails": [
                        {
                          "PaymentDt": "03/21/2026",
                          "PaymentAmt": "2000.00"
                          
                        },
                        {
                          "PaymentDt": "03/21/2026",
                          "PaymentAmt": "2000.00"
                        }
                        ],
                        "Month2TotTaxLiability": "500.00",
                        "Month3PaymentDetails": [
                        {
                          "PaymentDt": "03/21/2026",
                          "PaymentAmt": "2000.00"
                          
                        },
                        {
                          "PaymentDt": "03/21/2026",
                          "PaymentAmt": "2000.00"
                        }
                        ],
                        "Month3TotTaxLiability": "500.00"
                    },
                    "TotQtrTaxLiabilityAmt": "120.00",
                    "EmployeeDetails": [
                      {
                          "EmpSequenceId": "01",
                          "EmpId": null,
                          "EmpRef": "Pe011204121",
                          "SSN": "761-90-0098",
                          "FirstNm": "John",
                          "MiddleNm": "Joe",
                          "LastNm": "Smith",
                          "Suffix": "Jr",
                          "USAddress": {
                            "Address1": "19 Union Street",
                            "Address2": null,
                            "City": "Augusta",
                            "State": "ME",
                            "ZipCd": "04330"
                          },
                          "TaxWH": "1000.00"
                      },
                      {
                          "EmpSequenceId": "02",
                          "EmployeeId": null,
                          "EmpRef": "Payee09801231011",
                          "SSN": "761-34-0990",
                          "FirstNm": "John",
                          "MiddleNm": "Joe",
                          "LastNm": "Smith",
                          "Suffix": "Jr",
                          "USAddress": {
                              "Address1": "19 Union Street",
                              "Address2": null,
                              "City": "Augusta",
                              "State": "ME",
                              "ZipCd": "04330"
                          },
                          "TaxWH": "1000.00"
                      }

                      ],
                    "TotWHAmt": "2000.00"
                }
            }
        }
    ]
}

Response JSON

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019c65fa-9213-75c9-bc93-224d4e5ccdb2",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "34a5310b-7471-484a-a3a5-fbef97ac59d6",
          "PayerRef": null,
          "RecordId": "019c65fa-9f59-7644-b238-3e57b4d970e7",
          "FormType": "941ME",
          "EmployeeData": [
              {
                  "EmployeeId": "777b3a0c-6fc5-4b4a-b2c2-0e5c072b66e1"
              },
              {
                  "EmployeeId": "38e39974-f804-4fab-af94-544fe2925556"
              }
          ],
          "Status": "CREATED",
          "StatusTs": "2026-02-16 05:24:09 -05:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Create

Create

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON