Skip to main content
Version: 1.7.3

Create

Create

Use this endpoint to create Form NM ES903A (New Mexico Quarterly Tax and Wage Report) for an employer (payer), reporting quarterly wages, taxable wages, and unemployment insurance (UI) contributions due, along with required employee wage details for the corresponding quarter.

Note:

Form NM ES903A must be filed every quarter, even if no wages were paid.

POST StateFilings/NMUI/Create
Run in Postman

Request Body

FieldTypeDescription
StateUIRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
Size Range: ..50
ReturnHeaderObjectContains business information.
TaxYrstringThe tax year for which the Form ES903A is to be filed.
Allowed values

"2025", "2026"

QtrstringThe quarter for which the Form ES903A is to be filed.
Allowed values

"Q1", "Q2", "Q3", "Q4"

BusinessObjectObject to identify the business details.
BusinessIdGuidOptional Use the unique identifier provided in the response from the Business CREATE endpoint.
BusinessNmstringName of the business.
Size Range: ..75
TradeNmstringOptional Name under which the business operates.
Size Range: ..75
IsEINBooleanWhen true, identifies the business with an EIN.
EINorSSNstringWhen 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
EmailstringOptional Email address of the business.
Size Range: ..100
ContactNmstringOptional Name of the person who can be contacted by the State Agency.
Size Range: ..27
PhonestringOptional Phone number of the business.
Size Range: 10
PhoneExtnstringOptional Extension of the business phone number.
Size Range: ..5
FaxstringOptional Fax number of the business.
Size Range: 10
BusinessTypestringType of business.
Size Range: 4
Allowed values

"ESTE", "PART", "CORP", "EORG", "SPRO"

NamestringName of the signing authority.
Size Range: ..35
PhonestringPhone number of the signing authority.
Size Range: 10
BusinessMemberTypestringBusiness 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"

KindOfEmployerstringOptional Identifies the kind of employer.
Allowed values

"FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"

KindOfPayerstringOptional Identifies the kind of payer.
Allowed values

"REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"

IsBusinessTerminatedBooleanWhen true, indicates that the business is terminated.
IsForeignObjectWhen true, indicates that the business has a foreign address.
USAddressobjectIf IsForeign is false, pass the US address of the business.
Address1stringEmployer/Payer's US address (street or post office box of that locality).
Size Range: ..46
Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..46
CitystringEmployer/Payer's city.
Size Range: ..50
StatestringEmployer/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"

ZipCdstringEmployer/Payer's zip code.
Size Range: 5..10
ForeignAddressObjectIf IsForeign is true, pass the foreign address of the business.
Address1stringEmployer/Payer's foreign address (street address or post office box of that locality).
Size Range: ..50
Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..50
CitystringEmployer/Payer's city.
Size Range: ..50
ProvinceOrStateNmstringEmployer/Payer's province or state name.
Size Range: ..50
CountrystringEmployer/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"

PostalCdstringEmployer/Payer's postal code.
Size Range: ..16
ReturnDataObjectContains the return information.
FormES903AObjectIdentifies the Form ES903A data.
UIIdNumStringEmployer's New Mexico Unemployment Account Number
Size Range: 8 digits
Sample format: XXXXXXXX
WHIdNumStringEmployer's Combined Reporting System Identification number
Allowed values

99-999999-99-9*

IsNoWageReportedBooleanWhen true, indicates that no wage is reported in this quarter
TaxRateNumberTax rate for the quarter.
Size Range: 1-100
TotWagesAmtNumberTotal wages paid for the quarter.
Size Range: 0-99999999999.99
TotExcessWageAmtNumberTotal excess wages paid for the quarter.
Size Range: 0-99999999999.99
TotTaxableWagesNumberTotal taxable wages paid for all employees in the quarter that is subject to New Mexico Unemployment Insurance.
Size Range: 0-99999999999.99
TaxDueNumberTotal tax due for the quarter
Size Range: 0-99999999999.99
InterestNumberInterest for the quarter (1% per month after the due date).
Size Range: 0-99999999999.99
IsLateRepPenaltyBooleanIf true identifies that the employer is subject to late reporting penalty Note: Default penalty for late reporting is $50.00
PenaltyLateFilingNumberOptional Late filing penalty for the quarter.
Size Range: 0-99999999999.99
BalanceDueNumberTotal remittance due for the quarter.
Size Range: 0-99999999999.99
NumOfEmployeesObjectIdentifies the total number of employees for the quarter.
Month1TotEmployeesstringTotal number of employees in month 1 of the quarter.
Size Range: 0-9999999
Month2TotEmployeesstringTotal number of employees in month 2 of the quarter.
Size Range: 0-9999999
Month3TotEmployeesstringTotal number of employees in month 3 of the quarter.
Size Range: 0-9999999
TotIncomeTaxWHNumberTotal income tax witheld for all employees in the quarter.
Size Range: 0-99999999999.99
TotWCFeeNumberTotal Worker's Compensation fees for all employees in the quarter
Size Range: 0-99999999999.99
EmployeeDetailsObjectObject to identify the employee details.
EmpSequenceIdstringA unique number to identify this record.
Size Range: ..10
EmployeeIdGuidOptional A unique ID generated by TaxBandits after the return is created and returned in the response.
EmpRefstringA unique identifier of the employee.
UnitNumStringAn identification number to identify wages by worksite
Size range: 1-99999
SSNstringEmployee's Social Security Number (SSN).
Size Range: 9-11
FirstNmstringEmployee's first name.
Size Range: 15
MiddleNmstringOptional Employee's middle name.
Size Range: 15
LastNmstringEmployee's last name.
Size Range: 20
SuffixstringOptional Employee's suffix.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

IsOfficerBooleanWhen true, indicates that the employment type is Officer
IsMonth1BooleanWhen true, indicates the employee was employed during the month 1 of the quarter.
IsMonth2BooleanWhen true, indicates the employee was employed during the month 2 of the quarter.
IsMonth3BooleanWhen true, indicates the employee was employed during the month 3 of the quarter.
GrossWagesAmtNumberTotal gross wages reported for the quarter.
Size Range: ..99999999999.99
ExcessAmtNumberTotal excess wages for the quarter.
Size Range: ..99999999999.99
IncomeTaxWHNumberTotal taxable wages for the quarter.
Size Range: ..99999999999.99
WCFeeNumberTotal Worker's Compensation fees for the quarter
Size Range: ..99999999999.99

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier for a submission.
SuccessRecordsobject[]Provides detailed information about the success status of Form ES903A records.
SequenceIdstringA 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.
BusinessIdGuidUnique identifier for the business (payer) generated by TaxBandits.
PayerRefstringUnique identifier for the business (payer) provided by you.
RecordIdGuidA unique identifier generated by TaxBandits when a Form ES903A return is created.
FormTypestringType of form.
StatusstringReturns the record status.
StatusTsstringReturns the date and time when the return was created.
InfostringProvides additional information about the return.
Errorsobject[]Displays error information related to the state returns of Form ES903A.
IdstringReturns the validation error ID.
NamestringName of the validation error.
ErrorRecordsobject[]Provides detailed information about the error status of Form ES903A records.
SequenceIdstringA 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.
RecordIdGuidUnique identifier for the record.
Errorsobject[]Displays detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

{
    "StateUIRecords": [
        {
            "SequenceId": "001",
            "ReturnHeader": {
                "TaxYr": "2025",
                "Qtr": "Q4",
                "Business": {
                    "BusinessId": null,
                    "BusinessNm": "SnowDaze LLC",
                    "TradeNm": "Mayfill Tech",
                    "IsEIN": true,
                    "EINorSSN": "71-7676332",
                    "Email": "james@sample.com",
                    "ContactNm": "John",
                    "Phone": "7894561231",
                    "BusinessType": "ESTE",
                    "SigningAuthority": {
                        "Name": "James Smith",
                        "Phone": "9934567890",
                        "BusinessMemberType": "ADMINISTRATOR"
                    },
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "12 Main st",
                        "Address2": "CC avenue",
                        "City": "Rock Hill",
                        "State": "SC",
                        "ZipCd": "29730"
                    },
                    "ForeignAddress": null
                }
            },
            "ReturnData": {
                "FormES903A": {
                    "UIIdNum": "64573545",
                    "WHIdNum": "12-123456-12-4",
                    "IsNoWageReported": false,
                    "TaxRate": "5",
                    "TotWagesAmt": 2000,
                    "TotExcessWageAmt": 200,
                    "TotTaxableWages": 1800,
                    "TaxDue": 90,
                    "Interest": 10,
                    "LateRepPenalty": 25,
                    "PenaltyLateFiling": 100,
                    "BalanceDue": 225,
                    "NumOfEmployees": {
                        "Month1TotEmployees": 2,
                        "Month2TotEmployees": 0,
                        "Month3TotEmployees": 0
                    },
                    "TotIncomeTaxWH": 200,
                    "TotWCFee": 8.6,
                    "EmployeeDetails": [
                        {
                            "EmpSequenceId": "01",
                            "EmployeeId": null,
                            "EmpRef": "EmpRef001,
                            "UnitNum": "1",
                            "SSN": "234-48-4738",
                            "FirstNm": "Klaus",
                            "MiddleNm": "A",
                            "LastNm": "Thomas",
                            "Suffix": "Sr",
                            "IsOfficer": false,
                            "IsMonth1": true,
                            "IsMonth2": false,
                            "IsMonth3": false,
                            "GrossWagesAmt": 1000,
                            "TaxableWages": 900,
                            "ExcessAmt": 100,
                            "IncomeTaxWH": 100,
                            "WCFee": 4.30
                        },
                        {
                            "EmpSequenceId": "02",
                            "EmployeeId": null,
                            "EmpRef": null,
                            "UnitNum": "1",
                            "SSN": "784-83-8348",
                            "FirstNm": "James",
                            "MiddleNm": "A",
                            "LastNm": "Smith",
                            "Suffix": "Sr",
                            "IsOfficer": false,
                            "IsMonth1": true,
                            "IsMonth2": false,
                            "IsMonth3": false,
                            "GrossWagesAmt": 1000,
                            "TaxableWages": 900,
                            "ExcessAmt": 100,
                            "IncomeTaxWH": 100,
                            "WCFee": 4.30
                        }
                    ]
                }
            }
        }
    ]
}

Response JSON​

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019d0528-5321-7566-b1cd-0498fce88d84",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "fae28d96-bee4-414c-a81c-04a34143129e",
          "PayerRef": null,
          "RecordId": "019d0528-5b30-749c-98a4-5a9bf74961e4",
          "FormType": "ES903A",
          "EmployeeData": [
              {
                  "EmployeeId": "1e83929f-8510-4a59-a9e0-392cc465131b",
                  "EmpRef": null
              },
              {
                  "EmployeeId": "21507bd1-9143-48ed-b235-43e789deeed7",
                  "EmpRef": null
              }
          ],
          "Status": "CREATED",
          "StatusTs": "2026-03-19 04:13:44 -04:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}