Version: 1.7.3

Update

Use this endpoint to update the information on existing NYS-45 forms that are already created for a specific payer.

You cannot update a return once it has been transmitted.

PUTStateFilings/NYWHUI/Update

Run in Postman

Request Body

Field	Type	Description
StateWhUIRecords	Object[]	Object to create NYS45s
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 NYS45.
TaxYr	String	The tax year for which Form NYS45 needs to be filed. Allowed values 2025,2026
Qtr	String	The quarter for which the Form NYS45 is to be filed. Allowed values "Q1", "Q2", "Q3", "Q4"
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.
DateOperationCeased	DateTime	Enter the last payment date Allowed values MM/DD/YYYY or MM-DD-YYYY
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 NYS45 data.
FormNYS45	Object	California withholding/UI tax return.
BusinessTransferredType	string	Indicates whether the filer sold or transferred all or part of the business. Allowed values "WHOLE", "PART"
IsBusinessTransferred	Boolean	When true, identifies the business as transferred.
BusinessTransferredDetails	object	Type of Transfer and Record Keeper details
Name	string	Name of the Record Keeper
BusinessChangeType	string	Type of Transfer. Allowed values "SOLD", "TRANSFERRED"
DateOfChange	DateTime	Date of Sale / Transfer
NewBusinessType	string	New Business Type of the transferred business Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO"
NewBusinessName	string	New Business Name of the transferred business
IsForeign	Boolean	When true, identifies if the business has a foreign address.
USAddress	object	If IsForeign is false, pass US address of the business
Address1	string	Employer/Payer's US address (street address 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 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 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
IsDepHealthInsurance	Boolean	When true, Indicates whether health insurance is provided to employee's dependent.
IsCloseWHAcc	Boolean	When true, specifies that the account is to be cancelled.
LastPayrollDt	string	Enter tha last payroll date Allowed values MM/DD/YYYY or MM-DD-YYYY
IsSeasonal	Boolean	When true, Indicates whether the business operates on a seasonal basis.
SPICode	Number	2 digit code to indicate employer impacted by a disaster
UIDetails	Object	Object Identifies the information regarding the Unemployment Insurance details
UIIdNum	Number	Employer's New York Unemployment Account Number Size Range: 8 digits Allowed values ##-#####-#
NumOfEmp	Object	Total number of employees for the quarter
Month1Emp	Number	Total number of employees reported for month 1 of the quarter. Size Range: ..9999999
Month2Emp	Number	Total number of employees reported for month 2 of the quarter. Size Range: ..9999999
Month3Emp	Number	Total number of employees reported for month 3 of the quarter. Size Range: ..9999999
TotWages	Number	Total remuneration paid to all employees during the quarter, including wages above the UI wage base. Size Range: 0-999999999.99
TotExcessWages	Number	Total wages paid in excess of the UI wage base for employees during the quarter. Size Range: 0-999999999.99
TotTaxableWages	Number	Wages subject to UI contributions, calculated as Gross Wages minus Excess Wages. Size Range: 0-999999999.99
UITaxRate	Number	Applicable Unemployment Insurance rate for the quarter Size Range: 0-1
UITaxDue	Number	Total UI contributions due, calculated by applying the UI rate to taxable wages. Size Range: 0-999999999.99
TotReEmpContrib	Number	Re-employment service fund contribution, calculated as 0.075% of taxable wages. Size Range: 0-999999999.99
UISubTotal	Number	Subtotal of contributions due, equal to UI contributions plus re-employment contributions. Size Range: 0-999999999.99
Underpayment	Number	Amount of UI contributions previously underpaid, including any outstanding balance. Size Range: 0-999999999.99
BalanceDue	Number	Total amount due after adding previous underpayments to the current subtotal. Size Range: 0-999999999.99
Overpayment	Number	Amount of UI contributions previously overpaid and available as credit. Size Range: 0-999999999.99
UITotDue	Number	Final UI tax payable after adjusting subtotal with prior underpayments and overpayments. Size Range: 0-999999999.99
IsLiabRefund	Boolean	When true identifies the UI overpaid amount applied to outstanding liabilities or refund, or both
WHDetails	Object	Object Identifies the information regarding the Withholding details
WHIdNum	Number	New York withholding account number. Size Range: 12 Format: ##-#######-##-#
TotTaxWH	Number	Total New York State, New York City, and Yonkers tax withheld during the quarter Size Range: 0-999999999.99
Overpayment	Number	Withholding tax overpayment carried forward from the previous quarter Size Range: 0-999999999.99
TaxPaid	Number	Total withholding deposits made for the quarter, including all submitted payments Size Range: 0-999999999.99
BalanceDue	Number	Withholding tax amount due for the quarter after adjusting withheld tax with payments and prior overpayments. Size Range: 0-999999999.99
OverPaymentRecoveryType	string	Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Allowed values "REFUND", "APPLYTORETURN"
TotTaxDue	Number	Total amount due, including withholding tax payable and any other applicable liabilities Size Range: 0-999999999.99
EmployeeDetails	Object	Object that contains infromation 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.
EmployeeId	Guid	A unique identifier generated by TaxBandits for an employee. You can use this ID for your future reference to Update.
SSN	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
WageType	string	Indicates the type of wages reported Allowed values "REGULAR", "OTHER"
UIGrossWages	Number	Total unemployment insurance (UI) remuneration paid to the employee during the quarter, before deductions and without wage base limits. Size Range: 0-999999999.99
UIExcessWages	Number	Total unemployment insurance (UI) excess wages paid to the employee during the quarter Size Range: 0-999999999.99
UITaxableWages	Number	Total unemployment insurance (UI) taxable wages paid to the employee during the quarter Size Range: 0-999999999.99
WHGrossWages	Number	Federal gross wages are subject to withholding tax for the employee during the quarter. Size Range: 0-999999999.99
TotNYSWH	Number	Total New York State tax withheld from the employee's wages during the quarter. Size Range: 0-999999999.99
TotNYCWH	Number	Total New York City tax withheld from the employee's wages during the quarter. Size Range: 0-999999999.99
YonkersWH	Number	Total Yonkers tax withheld from the employee's wages during the quarter. Size Range: 0-999999999.99
TotWH	Number	Total withholding tax for the quarter, calculated as the sum of New York State, New York City, and Yonkers taxes withheld across all employees. Size Range: 0-999999999.99
NYTPRIN	string	New York Tax Preparer Registration Identification Number of the paid preparer, required if the preparer is registered in New York.
NYTPRINExclCode	string	Two-digit code indicating the reason the preparer is exempt from NYTPRIN registration, used when a NYTPRIN is not required.

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

{
    "SubmissionId": "019e4a50-e660-74f8-9955-3cdd1aef7a95",
    "StateWhUIRecords": [
        {
            "SequenceId": "001",
            "RecordId": "019e4a50-ed29-7136-b6b2-2e73897126dc",
            "ReturnHeader": {
                "Qtr": "Q1",
                "TaxYr": "2026",
                "Business": {
                    "BusinessId": "808850c1-d4a1-4ad1-86d0-f58e23f50502",
                    "BusinessNm": "Snowdaze LLC",
                    "PayerRef": null,
                    "FirstNm": null,
                    "MiddleNm": null,
                    "LastNm": null,
                    "Suffix": null,
                    "TradeNm": "Vertex Builders",
                    "IsEIN": true,
                    "EINorSSN": "45-1154828",
                    "Email": "natalie.zimmerman@vertexconstruction.com",
                    "ContactNm": "Natalie Zimmerman",
                    "Phone": "(803) 555-1234",
                    "PhoneExtn": null,
                    "Fax": null,
                    "BusinessType": "PART",
                    "SigningAuthority": {
                        "Name": "John",
                        "Phone": "(853) 123-1232",
                        "BusinessMemberType": "OWNER"
                    },
                    "KindOfEmployer": null,
                    "KindOfPayer": null,
                    "IsBusinessTerminated": false,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "350 5th Ave",
                        "Address2": "Floor 59",
                        "City": "New York",
                        "State": "NY",
                        "ZipCd": "10118"
                    },
                    "ForeignAddress": null,
                    "ACADetails": null
                }
            },
            "ReturnData": {
                "FormNYS45": {
                    "BusinessTransferredType": "PART",
                    "IsBusinessTransferred": true,
                    "BusinessTransferredDetails": {
                        "DateOfChange": "04/30/2026",
                        "NewBusinessName": "Baseline Enterprises",
                        "NewBusinessEIN": "12-3456780",
                        "USAddress": {
                            "Address1": "6910, Main St",
                            "Address2": "87th-Cordinal Avenue",
                            "City": "RokHill",
                            "State": "NC",
                            "ZipCd": "27201"
                        }
                    },
                    "IsDepHealthInsurance": false,
                    "IsCloseWHAcc": false,
                    "LastPayrollDt": null,
                    "IsSeasonal": false,
                    "SPICode": "15",
                    "UIDetails": {
                        "UIIdNum": "85-41257 3",
                        "NumOfEmp": {
                            "Month1Emp": 1,
                            "Month2Emp": 1,
                            "Month3Emp": 1
                        },
                        "TotWages": 4000,
                        "TotExcessWages": 2000,
                        "TotTaxableWages": 2000,
                        "UITaxRate": 1,
                        "UITaxDue": 2000,
                        "TotReEmpContrib": 1.5,
                        "UISubTotal": 2001.5,
                        "Underpayment": 2000,
                        "BalanceDue": 4001.5,
                        "Overpayment": 750,
                        "UITotDue": 3251.5,
                        "IsLiabRefund": false
                    },
                    "WHDetails": {
                        "WHIdNum": "12-3456789-01-2",
                        "TotTaxWH": 6000,
                        "Overpayment": 10000,
                        "TaxPaid": 10000,
                        "TotPayment": 20000,
                        "BalanceDue": "-14000",
                        "OverPaymentRecoveryType": "REFUND"
                    },
                    "TotTaxDue": 3251.5,
                    "EmployeeDetails": [
                        {
                            "EmpSequenceId": "12",
                            "EmployeeId": "14aa75b2-dc8b-48bf-8e6d-550c7b491336",
                            "EmpRef": "Payref002",
                            "SSN": "321-52-2023",
                            "FirstNm": "kelly",
                            "MiddleNm": "A",
                            "LastNm": "roger",
                            "Suffix": "Sr",
                            "WageType": "REGULAR",
                            "UIGrossWages": 4000,
                            "FedGrossWages": 2000,
                            "UIExcessWages": 2000,
                            "UITaxableWages": 2000,
                            "NYSWH": 2000,
                            "NYCWH": 2000,
                            "YonkersWH": 2000,
                            "USAddress": {
                                "Address1": "12 Main St",
                                "Address2": "CC avenue",
                                "City": "Rock Hill",
                                "State": "SC",
                                "ZipCd": "29730"
                            }
                        }
                    ],
                    "TotFedGrossWages": 2000,
                    "TotNYSTaxWH": 2000,
                    "TotNYCTaxWH": 2000,
                    "TotYonkersWH": 2000,
                    "TotTaxWH": 6000,
                    "NYTPRIN": "",
                    "NYTPRINExclCode": ""
                }
            }
        }
    ]
}

Response JSON

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019e4a50-e660-74f8-9955-3cdd1aef7a95",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "808850c1-d4a1-4ad1-86d0-f58e23f50502",
          "PayerRef": null,
          "RecordId": "019e4a50-ed29-7136-b6b2-2e73897126dc",
          "FormType": "NYS45",
          "EmployeeData": [
              {
                  "EmployeeId": "14aa75b2-dc8b-48bf-8e6d-550c7b491336",
                  "EmpRef": "Payref002"
              }
          ],
          "RemoveEmployeeData": [],
          "Status": "CREATED",
          "StatusTs": "2026-05-21 07:37:21 -04:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}

Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.

{
  "StatusCode": 401,
  "StatusMessage": "Unauthorized",
  "StatusName": "Invalid authorization 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

Update

Update

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON