Create a Registration Request with shared data

In order 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

paramtypedescription
acquiredbooleanHas this business been acquired?
acquisition_datestring "YYYY-mm-dd"Date of business acquisition, if acquired
contact_emailstringEmail of the primary contact for the registration
contact_namestringName of the primary contact
contact_phone_numberstringPhone number of the primary contact
dba_namestringDoing Business As name
description_of_operationstextDescription of the business' operations
einintegerEmployer Identification Number
employee_countintegerNumber of employees in the state
entity_typestringone of: c_corporation, s_corporation, llc
taxed_as_entity_typestringIf entity_type is 'llc', one of: c_corporation, s_corporation, individual, partnership
fiscal_year_endstring "YYYY-mm-dd"Date of the business' fiscal year end
futa_yearstring "YYYY-mm-dd"Year that FUTA liability was met, if any
industrystringThe industry title for the NAICS code of the business
legal_entity_changedbooleanHas there been a change to the structure of the business?
llc_structurestringIf entity type is 'llc', one of: SINGLE_MEMBER or MULTI_MEMBER
naics_codeintegerThe NAICS industry code of the business
non_profitbooleanIs this business a non-profit?
purposetextBrief description of the business
addressesarrayList of addresses for the business (format follows)
individualsarrayList of associated individuals for the business (format follows)
questionsarrayList of common state question key and values for the business (format follows)

Example Request Body

{
  "email": "[email protected]",
  "company_name": "Question Test 3",
  "external_id": "my-company-id-123",
  "state": "DC",
  "entity_type": "c_corporation",
  "contact_name": "John Doe",
  "non_profit": "true",
  "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": 0.1,
      "ssn": "123-45-6789",
      "dob": "1990-01-01",
      "address": {
        "address_line1": "570 Glenridge St.",
        "address_line2": null,
        "city": "Sewaren",
        "postal_code": "07077",
        "state": "NJ"
      }
    }
  ],
  "questions": [
    {		
      "key": "hire_date",
      "value": "2023-03-01"
    },
    {
      "key": "payroll_date",
      "value": "2023-03-02"
    },
    {
      "key": "employee_count",
      "value": 2
    },
    {
      "key": "primary_address",
      "value": {
        "address_line1": "577 Howard St",
        "address_line2": null,
        "city": "San Francisco",
        "postal_code": "94105-4635",
        "state": "CA",
        "address_type": "primary"
      }
    }
  ]
}

Object Formats

Address

paramtypedescription
address_line1stringStreet number and name of the address
address_line2stringSuite or Apt Number of the address
citystringCity of the address
statestringState abbreviation of the address
postal_codestringPostal code of the address
address_typestringType of the address: primary, secondary, mailing

Individual

paramtypedescription
namestringFull name of the individual
titlesarrayList 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
ssnstringSSN of the individual
dobstring "YYYY-mm-dd"Date of birth of the individual
ownership_percentagedecimalThe individuals percentage of ownership of the business
signatorybooleanIs this individual a signatory of the business?
addressaddressAddress of the individual

Question

paramtypedescription
keystringThe key associated with the question found in the list below
valuestring, integer, boolean, objectThe value / answer of the question

Common State Questions

      [
        {
          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"
        }
      ]