Optional parameters for registration requests

To reduce the amount of the data that an employer is required to submit to finish their registration, a breadth of optional parameters are available for submission along with a registration request. These parameters include business-level information as well as information regarding the business activity in the requested state. The common state questions and their associated keys are below. You can submit all, any, or none of the parameters listed. The more data you provide, the less is required from the employer.

Parameters

param	type	description
`contact_name`	string	Name of the primary contact for the registration
`contact_email`	string	Email of the primary contact
`contact_phone_number`	string	Phone number of the primary contact
`contact_title`	string	Title of the primary contact
`dba_name`	string	”Doing Business As” name for Company
`non_profit`	boolean	Is this business a non-profit?
`is_501c3_organization`	boolean	If non-profit, is this business a 501(c)(3) organization?
`entity_type`	string	one of: [‘corporation’, ‘llc’] (If non-profit one of: [‘nonprofit_corporation’, ‘nonprofit_llc’])
`llc_structure`	string	If entity_type is `llc`, one of: [‘SINGLE_MEMBER’, ‘MULTI_MEMBER’]
`taxed_as_entity_type`	string	one of: [‘c_corporation’, ‘s_corporation’, ‘individual’, ‘partnership’]
`formation_state`	string	State Company was formed [2 char abbr, like “CA”]
`formation_date`	date string	Date Company was formed (“YYYY-MM-DD”)
`ein`	string	Employer Identification Number (9 digits)
`description_of_operations`	text	Description of the business’ operations
`industry`	string	The industry title for the NAICS code of the business
`naics_code`	integer	The NAICS industry code of the business (6 digits)
`purpose`	text	Brief description of the business
`fiscal_year_end`	date string	Date of the business’ fiscal year end (“YYYY-MM-DD”)
`futa_year`	date string	Year that FUTA liability was met, if any (“YYYY-MM-DD”)
`registration_reason`	string	Reason for registration. One of [‘FIRST_EMPLOYEE’, ‘NEW_BUSINESS’, ‘ACQUIRED_REGISTERED’, ‘CHANGED_ENTITY_TYPE’]
`acquisition_date`	date string	If `registration_reason` is `'ACQUIRED_REGISTERED'`: Date of business acquisition (“YYYY-MM-DD”)
`acquisition_legal_name`	string	If `registration_reason` is `'ACQUIRED_REGISTERED'`: Legal name of acquired business
`acquisition_fein`	string	If `registration_reason` is `'ACQUIRED_REGISTERED'`: FEIN of acquired business
`acquisition_state_jurisdiction_ein`	string	If `registration_reason` is `'ACQUIRED_REGISTERED'`: State Jurisdiction EIN of acquired business
`previous_entity_type_change_date`	string	If `registration_reason` is `'CHANGED_ENTITY_TYPE'`: Date that entity type changed (“YYYY-MM-DD”)
`previous_entity_type_fein`	string	If `registration_reason` is `'CHANGED_ENTITY_TYPE'`: FEIN of business prior to entity type change
`previous_entity_type_state_jurisdiction_ein`	string	If `registration_reason` is `'CHANGED_ENTITY_TYPE'`: State Jurisdiction EIN of business prior to entity type change
`accounting_basis`	string	One of: [‘CASH’, ‘ACCRUAL’, ‘OTHER’]
`payroll_frequency`	string	One of: [‘WEEKLY’, ‘EVERY_OTHER_WEEK’, ‘SEMIMONTHLY’, ‘MONTHLY’]
`employee_count`	integer	Number of employees in the state registration is for
`addresses`	array	List of addresses for the business (format follows)
`individuals`	array	List of associated individuals for the business (format follows)
`questions`	array	List of common state question key and values for the business (format follows)

Example request body

1 {
2   "email": "test@email.com",
3   "company_name": "Question Test 3",
4   "external_id": "my-company-id-123",
5   "state": "MI",
6   "entity_type": "corporation",
7   "contact_name": "John Doe",
8   "non_profit": "false",
9   "addresses": [
10     {
11       "address_line1": "577 Howard St",
12       "address_line2": null,
13       "city": "San Francisco",
14       "postal_code": "94105-4635",
15       "state": "CA",
16       "address_type": "primary"
17     }
18   ],
19   "individuals": [
20     {
21       "name": "John Doe",
22       "titles": [
23         "President"
24       ],
25       "signatory": true,
26       "ownership_percentage": 10,
27       "ssn": "123-45-6789",
28       "dob": "1990-01-01",
29       "address": {
30         "address_line1": "570 Glenridge St.",
31         "address_line2": null,
32         "city": "Sewaren",
33         "postal_code": "07077",
34         "state": "NJ"
35       }
36     }
37   ],
38   "questions": [
39     {
40       "key": "hire_date",
41       "value": "2024-03-01"
42     },
43     {
44       "key": "payroll_date",
45       "value": "2024-03-10"
46     },
47     {
48       "key": "employee_count",
49       "value": 2
50     },
51     {
52       "key": "business_description",
53       "value": "Description of business"
54     },
55     {
56       "key": "contractors",
57       "value": "true"
58     },
59     {
60       "key": "contractor_duties",
61       "value": "Description of contractors duties"
62     },
63     {
64       "key": "primary_address",
65       "value": {
66         "address_line1": "577 Howard St",
67         "address_line2": null,
68         "city": "Lansing",
69         "postal_code": "94105-4635",
70         "state": "MI",
71         "address_type": "primary"
72       }
73     },
74     {
75       "key": "seasonal",
76       "value": "true"
77     },
78     {
79       "key": "seasonal_months",
80       "value": ["Jun", "Jul", "Aug", "Sep"]
81     }
82   ]
83 }

Object formats

Address

param	type	description
`address_line1`	string	Street number and name of the address
`address_line2`	string	Suite or Apt Number of the address
`city	string`	City of the address
`state	string`	State abbreviation of the address
`postal_code`	string	Postal code of the address
`address_type`	string	Type of the address: primary, secondary, mailing

Individual

param	type	description
`name`	string	Full name of the individual
`email`	string	Email of individual
`titles`	array	List of titles of the individual. Accepted values: [‘Chief Executive Officer’, ‘Chief Financial Officer’, ‘Chief Operating Officer’, ‘Chief Technology Officer’, ‘Chief Product Officer’, ‘Chief Business Officer’, ‘Chief Administrative Officer’, ‘Manager’, ‘Managing Member’, ‘Member’, ‘President’, ‘Secretary’, ‘Secretary/Treasurer’, ‘Treasurer’, ‘Vice President’]
`ssn`	string	SSN of the individual
`dob`	date string	Date of birth of the individual (“YYYY-MM-DD”)
`hired_date`	date_string	Date individual was hired to company (“YYYY-MM-DD”)
`ownership_percentage`	integer	The individuals percentage of ownership of the business
`signatory`	boolean	Is this individual a signatory of the business?
`director`	boolean	Is this individual a director of the business?
`llc_owner`	boolean	If business is LLC, is this individual a LLC owner?
`address`	address	Address of the individual

Question

param	type	description
`key`	string	The key associated with the question found in the list below
`value`	string, integer, boolean, object	The value or answer of the question

Common state questions

1 [
2   {
3     key: 'business_description',
4     question: "Please describe the business activity in the state"
5   },
6   {
7     key: 'contractor_duties',
8     question: "Please describe the duties of the independent contractors that work for you in the state"
9   },
10   {
11     key: 'contractors',
12     question: "Do any independent contractors work for you in the state?"
13   },
14   {
15     key: 'employee_count',
16     question: "Total number of employees in the state"
17   },
18   {
19     key: 'hire_date',
20     question: "Date employees hired/will be hired in the state"
21   },
22   {
23     key: 'payroll_date',
24     question: "Date of first payroll in the state"
25   },
26   {
27     key: 'primary_address',
28     question: "Primary or Employee Address in the state"
29   },
30   {
31     key: 'seasonal',
32     question: 'Is your business seasonal?'
33   },
34   {
35     key: 'seasonal_months',
36     question: "Please specify the months of your business' operation"
37   }
38 ]

Get a demo

Contact your account manager or contact sales to inquire about access.