The company object

Represents an employer.

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": {}
}
AttributeDescription
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.