Version: 2.0.0

Create

Use this endpoint to generate a new hire report for your employees. You must generate a separate report for each employee and can add multiple states in a single report.

Employer Details: Provide the BusinessId or PayerRef of the business you’re creating the report for.
Employee Details: Include the newly hired employee’s full name, Social Security Number (SSN), DOB and address.
Hire Date: Specify the employee’s hire date, as most states require reporting within a certain number of days from hire.
State Reporting: Indicate the state(s) where the report should be submitted.

POST NewHire/Employee/Create

Run in Postman

Request Body

Field	Type	Description
ReturnHeader	object	Identifies the supporting details of New Hire Form
Business	object	Object to identify the Business Details.
PayerRef	String	Optional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
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 giving the Business ID, you do not have to provide all the business information again.
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. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	String	Specify the TIN type of the business. Allowed values "EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN"
TIN	String	The TIN value, formatted according to the Format field selected.
IndividualNm	Object	Required when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNm	String	The first name of the individual. Size Range: 20
MiddleNm	String	Optional The middle name of the individual. Size Range: 20
LastNm	String	The last name of the individual. Size Range: 20
Suffix	String	Optional The suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
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. Optional at creation — additional DBAs can be added later via AddDBA.
DBANm	String	Name of the DBA. Size Range: 75
DBARef	String	Your unique identifier for this DBA. Size Range: 1-50
DBAId	GUID	TaxBandits-generated DBA identifier. Returned in the response.
Address	Object	Address information of 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. Size Range: 5-16 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"
Email	String
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 business. Size Range: 5-16
Country	String	2-character country code of the business. 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"
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
Suffix	String	Optional The suffix of the signatory. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	String	10 digits.
PhoneExtn	String	Optional Phone extension number of the signatory. Size Range: 5
BusinessMemberType	String	Optional Title or role of the signatory. 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"
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
Fax	string	Optional Fax number of the contact person. Size Range: 10 digits
ReturnData	string	Account number of the employee Size Range: ..12 Note: Account number is mandatory only for the following reporting states: Florida (FL) and Texas (TX)
EmployeeDetails	object[]	Data of the newhire employee
AccoutNumber	Boolean	Account number of the employer Size Range: ..12 Note: Account number is applicable only for the following reporting states: Florida (FL), Texas (TX), Kansas (KS) and Kentucky (KY)
StateEIN	string	State Employer Identification of the employer. Size Range: 10 Note: State EIN is currently applicable only for the following reporting states: Kentucky (KY)
IsEmployeeRegisteredInMultipleState	object	When true, identifies that the employer is reporting as a registered multistate employer. Note: Applicable only for the following reporting states: Florida (FL)
EmployeeSequenceId	string	A unique number given by an inbound application to identify records. Size Range: ..10
EmployeeId	string	Optional TaxBandits generates a unique ID for each employee after the return is created and returned in the Response. You can use this id for your future reference to update.
EmployeeRef	string	Optional A unique identifier for each employee completing their information. This identifier can be used in future references of the payee in the API. Size Range: ..50
SSN	string	Social Security Number of the employee Size Range: 9-11
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 employee Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Gender	string	Gender of the employee Allowed values "MALE", "FEMALE" Note: Applicable only if the reporting state is New Jersey (NJ)
Address	Object	Address information of 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. Size Range: 5-16 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"
DOB	string	Employee's date of birth. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY Example: 01/25/2025 or 01-25-2025
HireDate	string	Employee's hire date. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY Example: 01/25/2025 or 01-25-2025
ReportingState	string	Reporting state. Refer Static values. Size Range: 2 Allowed values "SC", "NC", "FL", "TX", "KY", "KS", "IN", "NJ"
IsHealthInsurance	Boolean	When true, identifies that the employee has medical insurance. Note: Applicable only if the reporting state is Florida (FL) or Indiana (IN)
IsEmployeeIndependentContractor	Boolean	When true, identifies that the employee is an independent contractor. Note: Applicable only if the reporting state is Florida (FL) and New Jersey (NJ)
EmployeeSalary	Number	Employee's salary Size Range: 0-9999999.99 Note: Applicable only if the reporting state is Texas (TX)
SalaryFrequency	string	Employee's Frequency Allowed values "ONE_TIME", "HOURLY", "WEEKLY", "BI_WEEKLY", "SEMI_WEEKLY", "MONHTLY", "QUARTERLY", "SEMI_ANNUALLY", "ANNUALLY" Note: Applicable only if the reporting state is Texas (TX)

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
BusinessId	Guid	Unique Identifier of the business
PayerRef	string	Unique identifier of the payer.
SuccessRecords	object[]	It will show the detailed information about the success status of New Hire Form Records.
SequenceId	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
EmployeeId	Guid	Unique Identifier of the business
EmpRef	string	Unique identifier of the payer.
Status	string	Returns the status of the records.
StatusTs	string	Returns date and time of return created.
Info	string	Returns information about the Federal Filing service.
Errors	object[]	Shows error information of state returns of New Hire form
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 NewHire Form Records.
SequenceId	string	An 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.
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": "019d6c14-a198-7234-8a7b-b067412cd498",
"ReturnHeader": {
  "Business": {
    "PayerRef": "Snow123",
    "BusinessId": null,
    "IsDefaultBusiness": true,
    "TINDetails": {
      "Format": "PLAIN_TIN",
      "TINType": "EIN",
      "TIN": "45-9875461"
    },
    "IndividualNm": {
      "FirstNm": "James",
      "MiddleNm": "A",
      "LastNm": "Anderson",
      "Suffix": "Jr"
    },
    "BusinessNm": "Snowdaze LLC",
    "NameCtrl": "SNOW",
    "DBADetails": {
      "DBANm": "Iceberg Icecreams",
      "DBARef": "DBA1001",
      "DBAId": null,
      "IsDefaultDBA": true,
      "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 1001",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCd": "29730",
        "Country": "US"
      }
    },
    "Email": "james@sample.com",
    "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": "8035551234",
      "PhoneExtn": "101",
      "Email": "contact@snowdaze.com",
      "Fax": "8035555678"
    }
  }
},
"ReturnData": {
  "EmpDetails": [
    {
      "AccNum": "001775343",
      "SEIN": "4569875621",
      "IsRegdMultiStateEmp": true,
      "SequenceIdEmployeeSequenceId": "1",
      "EmployeeId": null,
      "EmpRefEmployeeRef": "2344",
      "SSN": "001456924",
      "FirstNm": "Henry",
      "MiddleNm": null,
      "LastNm": "Smith",
      "Suffix": null,
      "Gender": "MALE",
      "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 1001",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCd": "29730",
        "Country": "US"
      },
      "DOB": "10/12/1992",
      "HireDate": "07/21/2025",
      "ReportingState": "NJ",
      "IsHealthInsurance": true,
      "IsEmployeeIndependentContractor": true,
      "HiredState": "AZ",
      "EmployeeSalary": "8000",
      "SalaryFrequency": "Monthly"
    }
  ]
}
}

Response JSON

{
"StatusCode": "200",
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "01993c3f-bd17-73ad-b4ca-8891c23f3118",
"SuccessRecords": [
  {
    "SequenceId": "001",
    "BusinessId": "da40ab7f-e8dc-4091-834b-b564a437c895",
    "PayerRef": null,
    "RecordId": "01993c3f-bdd6-71f0-ac13-27cd4b663571",
    "FormType": "SC1605",
    "Status": "CREATED",
    "StatusTs": "2025-09-12 00:47:14 -04:00",
    "Info": null,
    "Errors": null
  },
  {
    "SequenceId": "002",
    "BusinessId": "df7b1d1b-62c3-4cb0-a564-3958c0bea9cf",
    "PayerRef": null,
    "RecordId": "01993c3f-c322-71d5-ab35-0f70f59d72b2",
    "FormType": "SC1606",
    "Status": "CREATED",
    "StatusTs": "2025-09-12 00:47:15 -04:00",
    "Info": null,
    "Errors": null
  }
],
"ErrorRecords": null,
"Errors": null
}

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

Create

Create

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON