> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.middesk.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server. # Optional parameters for registration requests > Submit optional registration request data up front to reduce the information employers need to provide. 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](/api-reference/entity-management/registration-requests/create-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) | | `businesses` | array | List of businesses that own the business (format follows) | | `questions` | array | List of common state question key and values for the business (format follows) | **`Example request body`** ```json title="Example request body" { "email": "test@email.com", "company_name": "Question Test 3", "external_id": "my-company-id-123", "state": "MI", "entity_type": "corporation", "contact_name": "John Doe", "non_profit": "false", "addresses": [ { "address_line1": "577 Howard St", "address_line2": null, "city": "San Francisco", "postal_code": "94105-4635", "state": "CA", "address_type": "primary" } ], "individuals": [ { "name": "John Doe", "titles": [ "President" ], "signatory": true, "ownership_percentage": 10, "ssn": "123-45-6789", "dob": "1990-01-01", "address": { "address_line1": "570 Glenridge St.", "address_line2": null, "city": "Sewaren", "postal_code": "07077", "state": "NJ" } } ], "businesses": [ { "legal_name": "Parent Holdings LLC", "dba_name": "Parent Holdings", "ein": "12-3456784", "contact_email": "accounting@parentholdings.com", "ownership_percentage": 90, "ownership_start_date": "2021-05-01", "address": { "address_line1": "577 Howard St", "address_line2": null, "city": "San Francisco", "postal_code": "94105-4635", "state": "CA", "address_type": "primary" } } ], "questions": [ { "key": "hire_date", "value": "2024-03-01" }, { "key": "payroll_date", "value": "2024-03-10" }, { "key": "employee_count", "value": 2 }, { "key": "business_description", "value": "Description of business" }, { "key": "contractors", "value": "true" }, { "key": "contractor_duties", "value": "Description of contractors duties" }, { "key": "primary_address", "value": { "address_line1": "577 Howard St", "address_line2": null, "city": "Lansing", "postal_code": "94105-4635", "state": "MI", "address_type": "primary" } }, { "key": "seasonal", "value": "true" }, { "key": "seasonal_months", "value": ["Jun", "Jul", "Aug", "Sep"] } ] } ``` ## 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` | number | 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 | ### Business Use `businesses` to submit owners that are companies rather than people. Business owners can be submitted alongside `individuals`. | param | type | description | | ---------------------- | ----------- | ----------------------------------------------------------------- | | `legal_name` | string | Legal name of the business owner | | `dba_name` | string | "Doing Business As" name of the business owner | | `ein` | string | Employer Identification Number of the business owner (9 digits) | | `contact_email` | string | Contact email for the business owner | | `ownership_percentage` | number | The business owner's percentage of ownership of the business | | `ownership_start_date` | date string | Date the business owner acquired its ownership (**"YYYY-MM-DD"**) | | `address` | address | Address of the business owner | ### 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 ```json [ { key: 'business_description', question: "Please describe the business activity in the state" }, { key: 'contractor_duties', question: "Please describe the duties of the independent contractors that work for you in the state" }, { key: 'contractors', question: "Do any independent contractors work for you in the state?" }, { key: 'employee_count', question: "Total number of employees in the state" }, { key: 'hire_date', question: "Date employees hired/will be hired in the state" }, { key: 'payroll_date', question: "Date of first payroll in the state" }, { key: 'primary_address', question: "Primary or Employee Address in the state" }, { key: 'seasonal', question: 'Is your business seasonal?' }, { key: 'seasonal_months', question: "Please specify the months of your business' operation" } ] ``` > **Get a demo** > > Contact your account manager or [contact sales](https://www.middesk.com/contact-sales) to inquire about access.