The company object

The company object captures company payroll information, including payment frequency, bank account information, processing period, and Check onboarding status.

{
    "id": "com_sx3svU6K8c5ZkSFlOh5p",
    "legal_name": "Stark Industries, Inc.",
    "trade_name": "Stark Industries",
    "business_type": "c_corporation",
    "industry_type": "scientific_and_technical_services",
    "website": "https://www.starkindustries.com",
    "email": "[email protected]",
    "phone": "5551234567",
    "pay_frequency": "biweekly",
    "bank_accounts": [],
    "active": false,
    "processing_period": "four_day",
    "start_date": "2021-02-15",
    "onboard": {
        "status": "blocking",
        "blocking_steps": [
            "bank_account",
            "setup_parameters",
            "filing_authorization"
        ],
        "remaining_steps": [
            "bank_account",
            "setup_parameters",
            "filing_authorization"
        ],
        "bank_account": [
            "bank_account_exists",
            "bank_account_verified",
            "bank_account_debit_authorization_submitted"
        ],
        "setup_parameters": [
            {
                "id": "jur_NvIot3gvbIitui4Vmy9Z",
                "name": "Federal",
                "status": "blocking"
            },
            {
                "id": "jur_87N4QWPZ38kDSvkqAI7D",
                "name": "New York",
                "status": "needs_attention",
            },     
        ],
        "filing_authorization": [
            {
                "id": "frm_ozhx2ezrVsd2k2ScL7HU",
                "name": "Federal Form 8655",  
                "status": "blocking",
            },
            {
                "id": "frm_Iee3dIFvT1uBUYJ4PG7z",
                "name": "New York TR-2000",
                "status": "needs_attention",
            },    
            {
                "id": "frm_Y43LpYf60wEf3bCaN9Rn",
                "name": "New York TR-579-WT",
                "status": "needs_attention",
            },
        ],
    },
    "implementation": {
      	"status": "needs_attention",
        "remaining_steps": {
          	"kyb": {
              	"status": "not_initiated",
            },
        },
    },
    "in_good_standing": true,
    "address": {
        "line1": "200 Park Ave",
        "line2": null,
        "city": "New York",
        "state": "NY",
        "postal_code": "10166",
        "country": "US"
    },
    "principal_place_of_business": "wrk_kf7VlAT2024bG3ibQ1Kf",
    "employee_w2_delivery_method": null,
    "contractor_1099_delivery_method": null,
    "metadata": {},
    "default_bank_account": "bnk_v65m1wAKyyOYm37fLieP"
}

Attribute	Description
id string	Unique identifier for the company.
legal_name string	Legal name of the company. Cannot be updated unless `implementation.kyb.status` is `not_initiated`.
trade_name string	Trade name of the company.
other_business_name string	Other business name used by the company.
business_type string	Business type of the company. One of `sole_proprietorship`, `partnership`, `c_corporation`, `s_corporation`, or `llc`.
industry_type string	Industry type of the company. One of `auto_or_machine_sales`, `auto_or_machine_repair`, `arts_or_entertainment_or_recreation`, `cleaning_services`, `consulting_services`, `educational_services`, `family_care_services`, `financial_services`, `food_and_beverage_retail_or_wholesale`, `general_construction_or_general_contracting`, `health_care`, `hospitality_or_accommodation`, `hvac_or_plumbing_or_electrical_contracting`, `legal_services`, `non_food_retail_or_wholesale`, `other`, `personal_care_services`, `real_estate`, `restaurant`, `scientific_or_technical_services`, `security_services`, `tobacco_or_alcohol_sales`, or `transportation`.
website string	Website URL of the company.
email string	Email address of payroll department or administrator.
phone string	Phone number of the company.
pay_frequency string	Frequency by which the employees get paid. One of `weekly`, `biweekly`, `semimonthly`, `monthly`, `quarterly`, or `annually`.
bank_accounts array of strings	Read only. An array of bank account IDs. (Multiple bank accounts for a company is not yet supported, so this array will always have length 1).
active boolean	Indicates whether the company is active or archived within Check.
processing_period string	Number of days from payroll approval to payday. Following Check's risk review, companies are assigned one of the following values: `four_day` , `two_day`, and `one_day`. For `two_day`-approved companies, the processing period can be upgraded to `one_day` without restriction. On the other hand, the request would fail for `four_day`-approved companies.
start_date YYYY-MM-DD	Date the company will start using Check as their payroll processor. This date should match up with their first payday using Check. The validity of this date is important, as it's used on federal and state filing authorization forms to signify when Check's authorization to file on behalf of the employer starts.
onboard object	Structured information about the onboard status of the company.
implementation object	Structured information about the implementation status of the company.
in_good_standing boolean	Indicates if the company is considered to be In Good Standing with Check. As an example, if a company is delinquent on payments they would be marked `false` here. Any company which is not in good standing will not be able to run payroll.
address object	Legal address of company on file with the federal government. Cannot be updated unless `implementation.kyb.status` is `not_initiated`.
principal_place_of_business string	Company's workplace ID whose address would be printed on paystub, instead of legal address.
employee_w2_delivery_method string	Indicates how a company would like to deliver W-2s to employees. Set to `null` by default, but can be set to one of `manual`, `print_and_mail_all`, or `null`. If set to `manual`, Check will not print and mail W-2s to employees (apart from those that were paid in the current year and terminated). If set to `print_and_mail_all`, Check will print and mail W-2s to all employees who are slated to receive one.
contractor_1099_delivery_method string	Indicates how a company would like to deliver 1099s to contractors. Set to `null` by default, but can be set to one of `manual`, `print_and_mail_all`, or `null`. If set to `manual`, Check will not print and mail 1099s to contractors (apart from those that were paid in the current year and terminated). If set to `print_and_mail_all`, Check will print and mail 1099s to all contractors who are slated to receive one.
metadata object	Additional loosely structured information to associate with the company.
default_bank_account string	ID of the default bank account of the company. The default bank account is used for employer tax collections and refunds, as well as to fund payrolls unless the user explicitly sets the `bank_account` argument when creating or updating a payroll. The default bank account can be updated to be any one of the company's active bank accounts.