> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Company Object

> The Company object represents an employer in Zeal, including business details, owner information, and onboarding status.

The Company object represents an employer in Zeal.

| Attribute                  | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `companyID`                | string  | CompanyID of company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `status`                   | string  | Tracks the company onboarding lifecycle. Holds one of the following values: `initial_onboarding` (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 the previous payroll provider), `payment_permission_pending` (data migration is done but not ready to run payroll, usually pending banking partner information), `live` (ready to process payroll), `offboarded` (company has been offboarded) |
| `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  | Business address of company (Line 1 and Line 2 combined)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `business_city`            | string  | Business address of company (city)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `business_state`           | string  | Business address of the company (state abbreviation)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `business_zip`             | string  | Business address of company (5-digit zip code)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `business_phone`           | string  | Primary phone number of the company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `mail_address`             | string  | Mailing address of the company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `mail_city`                | string  | Mailing city of the company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `mail_state`               | string  | Mailing state of the company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `mail_zip`                 | string  | Mailing ZIP code of the company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `skip_migration`           | boolean | Defaults to `false`. If `true`, Zeal skips migrating payroll information from the company's old payroll provider. 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 the company's bank account                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `routing_number`           | string  | Routing number of the company's bank account                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `requirements`             | array   | List of required information for this company account (e.g. information that needs to be collected before running payments, payroll registration information, etc.). See [The Requirement Object](/reference/companies/the-requirement-object).                                                                                                                                                                                                                                                                                                 |
| `onboarding_url`           | string  | URL of the company's onboarding flow if the company is still onboarding (`status` is `initial_onboarding`). Otherwise `null`.                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `is_sandbox`               | boolean | Determines the test status of the company. `false` when the company was created in Production mode or using the Production API key.                                                                                                                                                                                                                                                                                                                                                                                                             |
| `ssn`                      | string  | Social Security Number of the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `ownership_percentage`     | integer | The ownership percentage held by the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `dob`                      | string  | Date of birth of the primary business owner, in `MM/DD/YYYY` format                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `legal_structure`          | enum    | One of: `ccorp`, `corp`, `estate`, `foreign_entity`, `llc`, `llp`, `lp`, `nonprofit`, `partnership`, `scheme`, `scorp`, `soleprop`, `trust`                                                                                                                                                                                                                                                                                                                                                                                                     |
| `job_title`                | string  | The job title of the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `address`                  | string  | Address of the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `address_line2`            | string  | Address line 2 of the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `city`                     | string  | City of the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `state`                    | string  | State of the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `zip`                      | string  | Zip code of the primary business owner                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `company_type`             | enum    | `all` for a company that supports both 1099 contractors and W-2 employees. `contractor_only` for a company that solely supports 1099 contractors.                                                                                                                                                                                                                                                                                                                                                                                               |
| `payroll_schedule`         | enum    | The default payroll schedule the company follows. One of: `daily`, `weekly`, `biweekly`, `semimonthly`, `monthly`                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `payroll_firstDate`        | date    | The ISO-8601 date of the first regular payroll                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `payroll_firstPayPeriodID` | string  | Reporting period ID of the first regular payroll                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

```json theme={null}
{
  "companyID": "1234567890",
  "status": "migration_pending",
  "first_name": "Erlich",
  "last_name": "Bachman",
  "email": "founder@aviato.com",
  "business_name": "Aviato",
  "business_ein": "083746568",
  "business_address": "1 Market St.",
  "business_city": "San Francisco",
  "business_state": "CA",
  "business_zip": "94105",
  "mail_address": "1 Market St.",
  "mail_city": "San Francisco",
  "mail_state": "CA",
  "mail_zip": "94105",
  "skip_migration": false,
  "business_phone": "4046762121",
  "account_number": "123456789",
  "routing_number": "0987654321",
  "requirements": [],
  "onboarding_url": null,
  "is_sandbox": true,
  "ssn": "22-333-4444",
  "ownership_percentage": 25,
  "dob": "01/01/1990",
  "legal_structure": "ccorp",
  "job_title": "CEO",
  "address": "1 Ferry Building",
  "city": "San francisco",
  "state": "CA",
  "zip": "94105",
  "company_type": "all",
  "payroll_firstDate": "2024-08-30",
  "payroll_schedule": "weekly",
  "payroll_firstPayPeriodID": "6580ce4a3808d60023b4e412"
}
```
