The company object

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

Shared enums: The pay_frequency field uses the same set of values as pay_frequency on the Payroll object and the Pay Schedule object.

{
    "id": "com_sx3svU6K8c5ZkSFlOh5p",
    "legal_name": "Stark Industries, Inc.",
    "trade_name": "Stark Industries",
    "statement_descriptor": "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": "three_day",
    "processing_period_eligibility": "two_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.
`statement_descriptor` string	Business name that will be included as part of ACH/RTP transactions for employee and contractor direct deposits, which will be displayed on employee bank statements. Maximum of 16 characters. If not provided, will default to the Check partner's originator name if provided, or "Check Payroll" if not.
`business_type` string	Business type of the company. One of `sole_proprietorship`, `partnership`, `c_corporation`, `s_corporation`, `llc` or `government_entity`.
`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`, `government_or_public_administration`,`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`. Defaults to `biweekly` if not provided in request
`bank_accounts` array of strings	Read only. An array of bank account IDs.
`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: `three_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 `three_day`-approved companies.
`processing_period_eligibility` string	The fastest processing period the company is eligible for. Companies may be eligible for a faster processing period than their current `processing_period`. Possible values are `two_day` and `one_day`. This field is `null` if the company is not eligible for a faster processing period than its current one.
`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.
`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. If set to `print_and_mail_all`, Check will print and mail W-2s to all employees who are slated to receive one. If set to `print_mail_to_employer`, Check will print all W-2s and mail them in bulk to the company’s `principal_place_of_business` if field is set and legal `address` otherwise.
`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. If set to `print_and_mail_all`, Check will print and mail 1099s to all contractors who are slated to receive one. If set to `print_mail_to_employer`, Check will print all 1099s and mail them in bulk to the employer’s address for distribution.
`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.