Skip to main content
Version: 2.0.0

Get

Get

Use this endpoint to retrieve the information of a previously created NJ-927 form for the corresponding business. Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.

POST StateFilings/NJWHUI/Get 

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return
RecordIdGuidA unique identifier generated by TaxBandits when a NJ927 return is created. Mention the return's Record ID that you want to get.

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
StateWHUIRecordsObject[]Object to identify the NJ927 records.
SequenceIdStringA unique identifier for this record.
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form NJ927 is to be filed.
QtrStringThe quarter for which the Form NJ927 is to be filed.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidThe unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint.
PayerRefstringThe unique identifier for the payer. Can replace BusinessId in future requests.
IsDefaultBusinessBooleanWhen set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetailsobjectTIN information for the business.
FormatstringSpecifies how the TIN is passed.
TINTypestringSpecifies the TIN type of the business. Allowed values"EIN".
TINstringThe TIN value according to the Format selected.
IndividualNmobjectRequired when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNmstringThe first name of the individual.
MiddleNmstringMiddle name of the individual.
LastNmstringThe last name of the individual.
SuffixstringSuffix of the individual's name.
BusinessNmstringLegal name of the business.
NameCtrlstringName control of the business as registered with the IRS.
DBADetailsobject[]DBA (Doing Business As) information.
DBANmstringName of the DBA.
DBARefstringUnique identifier for the DBA.
DBAIdGuidTaxBandits-generated DBA identifier.
Addressobject[]Address information of the DBA.
Address1stringStreet address or PO Box.
Address2stringSuite or apartment number.
CitystringDBA's city.
ProvinceOrStatestringDBA's province or state name.
ZipcdstringDBA's ZIP code.
CountrystringDBA's 2-character country code.
AddressobjectPrimary address of the business.
Address1stringStreet address or PO Box of the business.
Address2stringSuite or apartment number of the business.
CitystringCity of the business.
ProvinceOrStatestringProvince or state name of the business.
ZipCdstringZIP code of the business.
Countrystring2-character country code of the business.
ContactDetailsobject[]Details of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person.
MiddleNmstringMiddle name of the contact person.
LastNmstringLast name of the contact person.
SuffixstringThe suffix of the contact person.
PhonestringPhone number of the contact person.
PhoneExtnstringPhone extension number.
EmailstringEmail address of the contact person.
FaxstringFax number of the contact person.
BusinessTypeStringLegal structure of the business.
SigningAuthorityObjectDetails of the person authorized to sign the return. Mandatory for 94x forms.
FirstNmStringFirst name of the signatory.
MiddleNmStringMiddle name of the signatory.
LastNmStringLast name of the signatory.
SuffixStringThe suffix of the signatory.
PhoneStringPhone number of the signatory
PhoneExtnStringPhone extension number of the signatory.
BusinessMemberTypeStringTitle or role of the signatory.
ReturnDataObjectContains the return information.
FormNJ927ObjectNew Jersey withholding quarterly tax return.
AccountNumberstringAccount Number of the employer
BusinessPINstringBusiness PIN issued by the state
BusinessStartYearstringYear the business was established
TaxNoticeZipCodestringThe ZIP code associated with the address where tax notices should be sent.
UITaxRateNumberUnemployment Insurance (UI) rate
PlanTypestringType of Insurance plan enrolled for Employee
IsNoWageReportedBooleanIf true identifies that no wages have been paid for the quarter
EmployerTypestringType of Employer
RateDetailsobjectTax Rate details of the Employer
UIWFTaxRatestringEmployer's Unemployment Insurance and Workforce Development Partnership Fund (UIWF) tax rate
EmployerDITaxRatestringThe employer’s Disability Insurance (DI) tax rate applicable for the reporting period.
EmpDITaxRatestringThe employee-paid Disability Insurance (DI) tax rate applicable for the reporting period.
FLITaxRatestringThe Family Leave Insurance (FLI) tax rate applicable to the employee for the reporting period.
WithheldDetailsobjectTax withheld details of the Employer
Month1TaxWithheldNumberTotal Month 1 Tax Withheld
Month2TaxWithheldNumberTotal Month 2 Tax Withheld
Month3TaxWithheldNumberTotal Month 3 Tax Withheld
TotalWagesNumberTotal wages paid for the employee.
TotalTaxWithheldNumberTotal Tax Withheld
TaxPaidNumberPayments made for this quarter
BalanceDueNumberBalance due amount when TotTaxWH is greater than WHTaxDeposit.
OverpaymentNumberOverpayment from prior quarter
OverPaymentRecoveryTypeStringGets the overpayment recovery type. Whether to have the IRS refund the excess amount or apply it to next return.
TotalWithheldDueNumberTax Due after adjustments
UIDetailsObjectUnemployment insurance details of the Employer
NumberOfEmployeeObjectIdentifies the total number of employees for the quarter.
TotalMonth1EmployeestringTotal number of employees in month 1 of the quarter.
TotalMonth2EmployeestringTotal number of employees in month 2 of the quarter.
TotalMonth3EmployeestringTotal number of employees in month 3 of the quarter.
TotalGrossWagesNumberTotal wages paid for the quarter.
TotalExcessWagesNumberTotal excess wages paid for the quarter.
TotalTaxableWagesNumberTotal taxable wages paid for all employees in the quarter that is subject to New Jersey
DITaxableWagesNumberTotal Disability Insurance taxable wages paid for all employees in the quarter that is subject to New Jersey Unemployment Insurance.
EmployerTaxableWagesNumberTotal employer taxable wages in the quarter that are subject to New Jersey
FLITaxableWagesNumberThe total wages subject to Family Leave Insurance (FLI) tax for the reporting period.
TaxDueNumberThe Unemployment Insurance (UI) tax amount due for the reporting period.
EmployerDITaxDueNumberThe employer Disability Insurance (DI) tax amount due for the reporting period.
EmployeeDITaxDueNumberThe employee Disability Insurance (DI) tax amount due for the reporting period.
TotalDITaxDueNumberThe total Disability Insurance (DI) tax amount due for the reporting period.
FLITaxDueNumberThe Family Leave Insurance (FLI) tax amount due for the reporting period.
TaxPaidNumberThe UI tax amount already paid for the reporting period.
BalanceDueNumberThe remaining UI tax balance due after payments or credits.
TotalUIDueNumberTotal Unemployment Insurance Due after adjustments
PrivatePlanDetailsObjectObject to identify details of the private plan.
DIPrivateEmployeeNumberNumber of full-time and part-time covered employees insured under "Private Plan" for TDI who worked during or received pay for the pay period that included the 12th day of the 3rd month
FLIPrivateEmployeeNumberNumber of full-time and part-time covered employees insured under "Private Plan" for FLI who worked during or received pay for the pay period that included the 12th day of the 3rd month
TotalBalanceDueNumberThe total balance due after payments or credits.
TotalDueNumberTotal Due after adjustments
StatePaymentObjectObject that contains information about payment details for the Department of New Jersey
PaymentAmountNumberWithholding amount to be paid to the Department of New Jersey
PaymentRequestDatestringDate on which the withholding payment is requested.
UIobjectObject that contains information about UI payment details for the Department of New Jersey
PaymentAmountNumberUnemployment insurance amount to be paid to the Department of New Jersey
PaymentRequestDatestringDate on which the unemployment insurance payment is requested.
Errorsobject[]Shows detailed error information.
IdstringReturns the validation error Id.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON

StateFilings/NJWHUI/Get?RecordId=01999580-9061-77d5-86be-bc5686a6a5a5&SubmissionId=0199c8cc-6d8a-77a7-b401-aed04901d431

Response JSON

{
"SubmissionId": "019c65fa-9213-75c9-bc93-224d4e5ccdb2",
"StateWhUIRecords": [
{
"SequenceId": "001",
"RecordId": "019c65fa-9f59-7644-b238-3e57b4d970e7",
"ReturnHeader": {
"TaxYr": "2026",
"Qtr": "Q1",
"Business": {
"BusinessId": null,
"BusinessNm": "Snowdaze LLC",
"TradeNm": "Snowdaze",
"IsEIN": true,
"EINorSSN": "251674903",
"ContactNm": "John",
"Phone": "7894561231",
"PhoneExtn": "12345",
"Fax": "7123547895",
"BusinessType": "PART",
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"Address": {
"Address1": "123 Market St",
"Address2": "Suite 400",
"City": "San Francisco",
"State": "CA",
"ZipCd": "94105",
"PostalCd": null
},
"SigningAuthority": {
"Name": "John",
"Phone": "3231231232",
"BusinessMemberType": "OWNER"
}
}
},
"ReturnData": {
"FormNJ927": {
"AccountNumber": "123456789/000",
"BusinessPIN": "1234",
"BusinessStartYear": "1999",
"TaxNoticeZipCode": "12345",
"UITaxRate": "2.00",
"PlanType": "STATE",
"IsNoWageReported": false,
"EmployerType": "REGULAR",
"RateDetails": {
"UIWFTaxRate": "2.00",
"EmployerDITaxRate": "2.00",
"EmployeeDITaxRate": "2.00",
"FLITaxRate": "2.00"
},
"WithheldDetails": {
"Month1TaxWithheld": "50000.00",
"Month2TaxWithheld": "800.00",
"Month3TaxWithheld": "25000.00",
"TotalWages": "2000.00",
"TotalTaxWithheld": "2000.00",
"TaxPaid": "2500.00",
"BalanceDue": "20000.00",
"Overpayment": "600.00",
"OverPaymentRecoveryType": "REFUND",
"TotalWithheldDue": "200.00"
},
"UIDetails": {
"NumberOfEmployee": {
"TotalMonth1Employee": "50",
"TotalMonth2Employee": "124",
"TotalMonth3Employee": "46"
},
"TotalGrossWages": "100.00",
"TotalExcessWages": "100.00",
"FLIExcessWages": "100.00",
"TotalTaxableWages": "100.00",
"DITaxableWages": "100.00",
"EmployerTaxableWages": "100.00",
"FLITaxableWages": "100.00",
"TaxDue": "100.00",
"EmployerDITaxDue": "100.00",
"EmployeeDITaxDue": "100.00",
"TotalDITaxDue": "100.00",
"FLITaxDue": "100.00",
"TaxPaid": "100.00",
"BalanceDue": "100.00",
"TotalUIDue": "100.00"
},
"PrivatePlanDetails": {
"DIPrivateEmployee": "2",
"FLIPrivateEmployee": "2"
},
"TotalBalanceDue": "100.00",
"TotalDue": "100.00"
},
"StatePayment": {
"PaymentAmount": "100.00",
"PaymentRequestDate": "12/12/2026",
"UI": {
"PaymentAmount": "100.00",
"PaymentRequestDate": "12/12/2026"
}
}
}
}
],
"Errors": null
}