Version: 2.0.0

Get

Use this endpoint to retrieve the information of a previously created NUCS4072 form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.

GET StateFilings/NVUI/Get

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission. Not required when you are creating a return
RecordId	Guid	A unique identifier generated by TaxBandits when a Form NUCS4072 return is created.

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.
ReturnHeader	Object	Contains business information.
TaxYear	String	The tax year for which the Form NUS4072 is to be filed. Allowed values 2025,2026
Qtr	String	The quarter for which the Form NUS4072 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 providing 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.
TINType	string	Specify the TIN type of the business. Allowed values "EIN"
TIN	string	The TIN value according to the Format selected.
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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
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"
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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
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
Email	string	Optional Email address of the contact person. Size Range: ..100
Fax	string	Optional Fax number of the contact person. Size Range: 10 digits
ReturnData	Object	Contains the return information.
BusinessType	String	Legal structure of the business. Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO", "SLGOV"
SigningAuthority	Object	Details of the person authorized to sign the return. Mandatory for 94x forms.
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
Phone	String	Optional Phone number of the signatory. Size Range: 10
PhoneExtn	String	Optional Phone extension number of the signatory. Size Range: 5
ReturnData	Object	Contains the return information.
FormNUCS4072	Object	Identifies the Form NUS4072 data.
UIIdNumber	String	Employer's Nevada Unemployment Account Number. Size Range: 9 digits Sample Format: "999999999"
UITaxRate	Number	Tax rate for the quarter. Size Range: 0-100
IsNoWageReported	Boolean	When true, indicates that no wage is reported in this quarter.
IsBusinessTerminated	Boolean	When true, it indicates that the business has terminated.
TotalGrossWages	Number	Total gross wages reported for all employees for the quarter. Size Range: 0-999999999999.99
TotalTaxableWages	Number	Total taxable wages reported for all employees for the quarter. Size Range: 0-999999999999.99
TotalExcessWages	Number	Total excess wages reported for all employees for the quarter. Size Range: 0-999999999999.99
UITaxDue	Number	Unemployment insurance tax due for the reported taxable wages. Size Range: 0-99999999999.99
CEPTaxDue	Number	CEP tax due for the reported taxable wages. Note: CEP Tax Due is calculated by multiplying the taxable wages by the CEP tax rate of 0.05%. Size Range: 0-99999999999.99
Overpayment	Number	Optional Overpayment from prior quarter. Size Range: 0-999999999.99
Interest	Number	Optional Interest for the quarter. Size Range: 0-999999999.99
LateFilingPenalty	Number	Optional Late filing penalty. Size Range: 0-999999999.99
AdditionalLateFilingPenalty	Number	Optional Additional late filing penalty. Size Range: 0-999999999.99
TotalNumberOfEmployees	Number	Total Number of part-time and full-time employees covered in the quarter. Size Range: 0-9999999
NumberOfEmployees	Object	Identifies the total number of employees for the quarter.
TotalMonth1Employee	string	Total number of employees in month 1 of the quarter. Size Range: 0-9999999
TotalMonth2Employee	string	Total number of employees in month 2 of the quarter. Size Range: 0-9999999
TotalMonth3Employee	string	Total number of employees in month 3 of the quarter. Size Range: 0-9999999
EmployeeDetails	Object[]	Object to identify the employee details.
EmployeeSequenceId	string	A unique number to identify this record. Size Range: ..10
EmployeeId	Guid	Optional A unique ID generated by TaxBandits after the return is created and returned in the response.
SSN	string	Employee's Social Security Number (SSN). Size Range: 9-11
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional Employee's middle name. Size Range: 20
LastNm	string	Employee's last name. Size Range: 20
Suffix	string	Optional Employee's suffix. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
GrossWages	Number	Total gross wages paid to the employee during the reporting quarter. Size Range: 0-999999999999.99
TotalTips	Number	Total covered tips to the employee during the reporting quarter. Size Range: 0-999999999999.99
OutOfStateCode	Number	Out of state code of the employee. 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", "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"
OutOfStateGrossWages	Number	Out of state gross wages of the employee. Size Range: 0-999999999999.99
Errors	Object	Shows detailed error information.
Id	string	Total amount due.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request JSON

/statefilings/nvui/get?RecordId=019d2ee9-bac0-76b9-a65a-f72168d84d3f&SubmissionId=01a12044-6171-75ed-ac67-07e7062f0e21

Response JSON

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

{
  "SubmissionId": "01a1206b-8f7b-72a2-abfd-b0c3f7e9c583",
  "StateUIRecords": [
      {
          "SequenceId": "001",
          "RecordId": "01a1206b-99cc-720e-a8c3-e0abdcda28b7",
          "ReturnHeader": {
              "Qtr": "Q3",
              "TaxYear": "2026",
              "Business": {
                  "BusinessId": "453f9fe9-528c-4982-b70f-505bacf5d08f",
                  "PayerRef": "Snow12345679",
                  "IsDefaultBusiness": true,
                  "TINDetails": {
                      "Format": "PLAIN_TIN",
                      "TINType": "EIN",
                      "TIN": "45-9679233"
                  },
                  "BusinessNm": "Snowdaze LLC",
                  "DBADetails": {
                      "DBANm": "Iceberg Icecreams",
                      "DBARef": "DBA1001",
                      "DBAId": "000224CA-E5A0-40A7-8B8B-BC1334CE2716",
                      "Address": {
                          "Address1": "395 CENTRAL AVE W.",
                          "Address2": "Suite 1001",
                          "City": "Saint Paul",
                          "ProvinceOrState": "NV",
                          "ZipCd": "89431",
                          "Country": "US"
                      }
                  },
                  "Address": {
                      "Address1": "395 CENTRAL AVE W.",
                      "Address2": "Suite 1001",
                      "City": "Saint Paul",
                      "ProvinceOrState": "NV",
                      "ZipCd": "89431",
                      "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": "SLGOV",
                  "SigningAuthority": {
                      "FirstNm": "Michael",
                      "MiddleNm": "A",
                      "LastNm": "Carter",
                      "Suffix": "Jr",
                      "Phone": "(972) 555-0100",
                      "PhoneExtn": "23456",
                      "BusinessMemberType": "ADMINISTRATOR"
                  },
                  "KindOfEmployer": null,
                  "KindOfPayer": null
              }
          },
          "ReturnData": {
              "FormNUCS4072": {
                  "UIIdNumber": "222289222",
                  "IsBusinessTerminated": false,
                  "IsNoWageReported": false,
                  "NumberOfEmployees": {
                      "TotalMonth1Employees": 0,
                      "TotalMonth2Employees": 1,
                      "TotalMonth3Employees": 0
                  },
                  "UITaxRate": "0.54",
                  "TotalGrossWages": 8525,
                  "TotalExcessWages": 5115,
                  "TotalTaxableWages": 3410,
                  "UITaxDue": 18.41,
                  "CEPTaxDue": 1.71,
                  "Overpayment": 0,
                  "Interest": 0,
                  "LateFilingPenalty": 0,
                  "AdditionalLateFilingPenalty": 0,
                  "TotalUITaxDue": 20.12,
                  "TotalNumberOfEmployees": 1,
                  "EmployeeDetails": [
                      {
                          "EmployeeSequenceId": "01",
                          "EmployeeId": "24b3bcbb-7537-40db-87db-d4a26b369643",
                          "EmployeeRef": null,
                          "SSN": "187-88-6601",
                          "FirstNm": "James",
                          "MiddleNm": "A",
                          "LastNm": "Brown",
                          "Suffix": null,
                          "Address": null,
                          "GrossWages": 8525,
                          "TotalTips": 8484,
                          "OutOfStateCode": "PR",
                          "OutOfStateGrossWages": 3711
                      }
                  ]
              }
          }
      }
  ],
  "Errors": null
}

Bad Request Response - You'll get the below response when your API requests contain any validation errors.

{
  "SubmissionId": null,
  "StateUIRecords": null,
  "Errors": [
      {
          "Id": "S00-000099",
          "Name": "RecordId",
          "Message": "RecordId is invalid."
      }
  ]
}

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"
      }
  ]
}

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

Get

Get

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON