Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Companies

Get a company

Get a company.

The employees:read scope is required to return home_address and non-work locations. The company_admin:read scope is required to return primary_payroll_admin. The signatories:read scope is required to return primary_signatory.

scope: companies:read

get/v1/companies/{company_id}

Path parameters

company_idstring required

The UUID of the company

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

successful

einstring

The Federal Employer Identification Number of the company.

entity_type'C-Corporation' | 'S-Corporation' | 'Sole proprietor' | 'LLC' | 'LLP' | 'Limited partnership' | 'Co-ownership' | 'Association' | 'Trusteeship' | 'General partnership' | 'Joint venture' | 'Non-Profit' nullable

The tax payer type of the company.

contractor_onlyboolean

Whether the company only supports contractors.

tier'simple' | 'plus' | 'premium' | 'core' | 'complete' | 'concierge' | 'contractor_only' | 'basic' nullable

The Gusto product tier of the company (not applicable to Embedded partner managed companies).

is_suspendedboolean

Whether or not the company is suspended in Gusto. Suspended companies may not run payroll.

company_status'Approved' | 'Not Approved' | 'Suspended'

The status of the company in Gusto. "Approved" companies are approved to run payroll from a risk and compliance perspective. However, an approved company may still need to resolve other payroll blockers to be able to run payroll. "Not Approved" companies may not yet run payroll with Gusto and may need to complete onboarding or contact support. "Suspended" companies may not run payroll with Gusto. In order to unsuspend their account, the company must contact support.

uuidstring required

A unique identifier of the company in Gusto.

namestring

The name of the company.

slugstring

The slug of the name of the company.

trade_namestring nullable

The trade name of the company.

is_partner_managedboolean

Whether the company is fully managed by a partner via the API

is_high_risk_businessboolean

Whether or not Gusto has identified the company as representing a high fraud risk.

is_marijuana_businessboolean

Whether or not the company is a marijuana-related business.

pay_schedule_type'single' | 'hourly_salaried' | 'by_employee' | 'by_department' nullable

The pay schedule assignment type.

join_datestring nullable

Company's first invoiceable event date

funding_type'ach' | 'reverse_wire' | 'wire_in' | 'partner_disbursement' | 'rtp' | 'line_of_credit' nullable

Company's default funding type

Example response

{
  "compensations": {
    "hourly": [
      {
        "name": "Overtime",
        "multiple": 1.5
      }
    ],
    "fixed": [
      {
        "name": "Bonus"
      }
    ],
    "paid_time_off": [
      {
        "name": "Vacation Hours"
      }
    ]
  }
}