The Company Object

The Company Object represents an employer in Zeal.

attributes

type

description

companyID

string

CompanyID of company

status

string

Tracks the company onboarding lifecycle. Holds one of the following values:
initial onboarding: This company is still onboarding
payroll_access_needed: Zeal still needs access to this company's previous payroll provider to migrate records
migration_pending: Zeal is still migrating records from previous payroll provider
contract_pending:
needs_more_info:
live: Company is ready

first_name

string

First Name of Primary Business Owner

last_name

string

Last Name of Primary Business Owner

email

string

Email Address of Primary Business Owner

business_name

string

Business Name

business_ein

string

FEIN of company

business_address

string

Mailing Address of company (Line 1 and Line 2 combined)

business_city

string

Mailing Address of company (City)

business_state

string

Mailing address of company (State abbreviation)

business_zip

string

Mailing Address of company (5 digit zipcode)

business_phone

string

Primary phone number of company

skip_migration

boolean

If true, Zeal will skip migrating payroll information from the company's old payroll provider.

Note: please confirm with the company that migration is not necessary. Failure to migrate old records may impact tax reporting and filing.

account_number

string

Account number of company's bank account

routing_number

string

Routing number of company's bank account

state_tax_numbers

object

State Payroll Tax Numbers (also known as State Payroll IDs) for this company. A company should have a State Payroll Tax Number for a state before an employee can be paid in that state

state_sui_numbers

object

State Unemployment Insurance (SUI) Numbers for this company. A company should have a SUI number for a state before an employee can be paid in that state.

requirements

array

List of requirement information for this company account (e.g. information that needs to be collected before running payments, payroll registration information, etc.). See The Requirement Object for more information.

onboarding_url

string

URL of the company's onboarding flow if the company is still onboarding i.e. status is initial_onboarding. Otherwise this field has a value of null

is_sandbox

boolean

Set to false when a company has finished micro deposit verification

{
  "companyID": "1234567890",
  "status": "migration_pending",
  "first_name": "Asa Griggs",
  "last_name": "Candler",
  "email": "[email protected]",
  "business_name": "Coca-Cola",
  "business_ein": "083746568",
  "business_address": "1 Coca Cola Plz NW",
  "business_city": "Atlanta",
  "business_state": "GA",
  "business_zip": "30313",
  "skip_migration": false,
  "business_phone": "4046762121",
  "account_number": "123456789",
  "routing_number": "0987654321",
  "state_tax_numbers": {
     "VA": "853-926938023",
     "CA": "97282937463-2332"
  },
  "state_sui_numbers": {
     "TX": "072873649233"
  },
  "requirements": [],
  "onboarding_url": null,
  "is_sandbox" : true
}