Get
Get
Use this endpoint to retrieve the information of a previously created NM ES903A form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.
GET StateFilings/NMUI/Get Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. |
| RecordId | Guid | A unique identifier generated by TaxBandits when a Form ES903A 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. |
| StateUIRecords | Object[] | Object to identify the records. |
| SequenceId | String | A unique identifier for this record. |
| RecordId | Guid | A unique identifier generated by TaxBandits when a Form ES903A return is created. |
| ReturnHeader | Object | Contains business information. |
| TaxYear | String | The tax year for which the Form ES903A is to be filed. |
| Qtr | String | The quarter for which the Form ES903A is to be filed. |
| Business | object | Object to identify the Business Details. |
| BusinessId | Guid | The unique Business ID (Generated by TaxBandits) that is received in the response of the Business CREATE Endpoint. |
| PayerRef | string | The unique identifier for the payer. Can replace BusinessId in future requests. |
| 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. |
| TINType | string | Specify the TIN type of the business. |
| TIN | string | The TIN value according to the Format selected. |
| IndividualNm | object | Object to identify Individual name. |
| FirstNm | string | The first name of the individual. |
| MiddleNm | string | Middle name of the individual. |
| LastNm | string | The last name of the individual. |
| Suffix | string | Suffix of the individual's name. |
| BusinessNm | string | Legal name of the business. |
| NameCtrl | string | Name control of the business as registered with the IRS. |
| DBADetails | object[] | DBA (Doing Business As) information. |
| DBANm | string | Name of the DBA. |
| DBARef | string | Unique identifier for the DBA. |
| DBAId | Guid | TaxBandits-generated DBA identifier. |
| Address | object[] | Address information of the DBA. |
| Address1 | string | Street address or PO Box. |
| Address2 | string | Suite or apartment number. |
| City | string | DBA's city. |
| ProvinceOrState | string | DBA's province or state name. |
| Zipcd | string | DBA's ZIP code. |
| Country | string | DBA's 2-character country code. |
| string | Email address of the Business. | |
| Address | object | Primary address of the business. |
| Address1 | string | Street address or PO Box of the business. |
| Address2 | string | Suite or apartment number of the business. |
| City | string | City of the business. |
| ProvinceOrState | string | Province or state name of the business. |
| ZipCd | string | ZIP code of the business. |
| Country | string | 2-character country code of the business. |
| ContactDetails | object[] | Details of the person the IRS can contact regarding the given business. |
| FirstNm | string | First name of the contact person. |
| MiddleNm | string | Middle name of the contact person. |
| LastNm | string | Last name of the contact person. |
| Suffix | string | The suffix of the contact person. |
| Phone | string | Phone number of the contact person. |
| PhoneExtn | string | Phone extension number. |
| string | Email address of the contact person. | |
| Fax | string | Fax number of the contact person. |
| ReturnData | Object | Contains the return information. |
| BusinessType | String | Legal structure of the business. |
| SigningAuthority | Object | Details of the person authorized to sign the return. Mandatory for 94x forms. |
| FirstNm | String | First name of the signatory. |
| MiddleNm | String | Middle name of the signatory. |
| LastNm | String | Last name of the signatory. |
| Suffix | String | The suffix of the signatory. |
| Phone | String | Phone number of the signatory. |
| PhoneExtn | String | Phone extension number of the signatory. |
| BusinessMemberType | String | Title or role of the signatory. |
| ReturnData | Object | Contains the return information. |
| FormES903A | Object | Identifies the Form ES903A data. |
| UIIdNum | String | Employer's New Mexico Unemployment Account Number. |
| WHIdNum | String | Employer's Combined Reporting System Identification number. |
| IsNoWageRptd | Boolean | When true, indicates that no wage is reported in this quarter. |
| UITaxRate | Number | Tax rate for the quarter. |
| TotGrossWages | Number | Total wages paid for the quarter. |
| TotExcessWages | Number | Total excess wages paid for the quarter. |
| TotTaxableWages | Number | Total taxable wages paid for all employees in the quarter that is subject to New Mexico Unemployment Insurance. |
| UITaxDue | Number | Total tax due for the quarter. |
| Interest | Number | Interest for the quarter (1% per month after the due date). |
| LateRepPenalty | Number | Late reporting penalty for the quarter. |
| LateFilingPenalty | Number | Late filing penalty for the quarter. |
| TotUIDue | Number | Total remittance due for the quarter. |
| NumOfEmp | Object | Identifies the total number of employees for the quarter. |
| TotMonth1Emp | string | Total number of employees in month 1 of the quarter. |
| TotMonth2Emp | string | Total number of employees in month 2 of the quarter. |
| TotMonth3Emp | string | Total number of employees in month 3 of the quarter. |
| TotWCFee | Number | Total Worker's Compensation fees for all employees in the quarter. |
| EmpDetails | Object | Object to identify the employee details. |
| EmployeeSequenceId | string | A unique number to identify this record. |
| EmpId | Guid | A unique ID generated by TaxBandits after the return is created and returned in the response. |
| EmployeeRef | string | A unique identifier of the employee. |
| UnitNum | String | An identification number to identify wages by worksite. |
| SSN | string | Employee's Social Security Number (SSN). |
| FirstNm | string | Employee's first name. |
| MiddleNm | string | Employee's middle name. |
| LastNm | string | Employee's last name. |
| Suffix | string | Employee's suffix. |
| IsOfficer | Boolean | When true, indicates that the employment type is Officer. |
| IsMonth1 | Boolean | When true, indicates the employee was employed during the month 1 of the quarter. |
| IsMonth2 | Boolean | When true, indicates the employee was employed during the month 2 of the quarter. |
| IsMonth3 | Boolean | When true, indicates the employee was employed during the month 3 of the quarter. |
| GrossWages | Number | Total gross wages reported for the quarter. |
| TaxWH | Number | Total taxable wages for the quarter. |
| WCFee | Number | Total Worker's Compensation Fees for the quarter. |
| Errors | Object[] | Shows detailed error information. |
| Id | string | Total due amount. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
"statefilings/nmui/Get?SubmissionId=01a0e76d-3a0a-71b7-a528-47704db355cb&RecordId=01a0e76d-3ec5-751e-9d37-c1c39484c222"
Response JSON
- 200
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "01a0e76d-3a0a-71b7-a528-47704db355cb",
"StateUIRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e76d-3ec5-751e-9d37-c1c39484c222",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "f89545f6-1277-405d-ade7-0dd4b94ae020",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "48-7789266"
},
"BusinessNm": "Snowdaze LLC",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "D8EB0DCD-B112-4696-82A5-99F9825A4347",
"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": "(803) 555-1234",
"PhoneExtn": "101",
"Email": "contact@snowdaze.com",
"Fax": "(803) 555-5678"
},
"BusinessType": "ESTE",
"SigningAuthority": {
"FirstNm": "Ambrane",
"MiddleNm": "A",
"LastNm": "Cavil",
"Suffix": "Jr",
"Phone": "(803) 555-1000",
"PhoneExtn": "111",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": null,
"KindOfPayer": null
}
},
"ReturnData": {
"FormES903A": {
"UIIdNum": "64573545",
"WHIdNum": "12-123456-17-4",
"IsNoWageRptd": false,
"UITaxRate": 12,
"TotGrossWages": 20000,
"TotExcessWages": 2000,
"TotTaxableWages": 18000,
"UITaxDue": 2160,
"Interest": 100,
"LateRepPenalty": 25,
"LateFilingPenalty": 100,
"TotUIDue": 2385,
"NumOfEmp": {
"TotMonth1Emp": 2,
"TotMonth2Emp": 0,
"TotMonth3Emp": 0
},
"TotIncomeTaxWH": 1125,
"TotWCFee": 8.3,
"EmpDetails": [
{
"EmployeeSequenceId": "01",
"EmployeeId": "fab009f3-2fe9-4f1a-8e1c-4a859f330ad2",
"EmployeeRef": null,
"UnitNum": "1",
"SSN": "396-57-9747",
"FirstNm": "John",
"MiddleNm": "A",
"LastNm": "Smith",
"Suffix": "Sr",
"IsMonth1": true,
"IsMonth2": false,
"IsMonth3": false,
"IsOfficer": false,
"GrossWages": 10000,
"ExcessWages": 1000,
"TaxWH": 1000,
"WCFee": 4
},
{
"EmployeeSequenceId": "02",
"EmployeeId": "d5562997-498b-427e-9bb2-52043ae9929e",
"EmployeeRef": null,
"UnitNum": "166",
"SSN": "792-66-1307",
"FirstNm": "John",
"MiddleNm": "A",
"LastNm": "Smith",
"Suffix": "Sr",
"IsMonth1": true,
"IsMonth2": false,
"IsMonth3": false,
"IsOfficer": false,
"GrossWages": 10000,
"ExcessWages": 1000,
"TaxWH": 125,
"WCFee": 4.3
}
]
}
}
}
],
"Errors": null
}