---
title: "company"
method: GET
path: "/v{version}/companies/{id}"
tags: ["Company"]
---

# company

`GET /v{version}/companies/{id}`

Returns a company.<p>Scopes: export_company_info</p>

## Path parameters

- `id` string, required
- `version` string, required

## Response `200`

OK

- DtosCompany
  - `id` string, required — The id of the company.
  - `name` string, required — The name of the company.
  - `type` 'Application' | 'Broker' | 'Client' | 'Partner' | 'Ease', required — The type of the company.
  - `ein` string — The EIN of the company.
  - `sic` string — The SIC of the company.
  - `nature` string — The Nature of Business of the company.
  - `established_date` string — The Established Date of the company.
  - `entity_type` string — The Entity Type of the company.
  - `website` string — The Website of the company.
  - `agency` DtosBrokerLink
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `agent` DtosAgentLink
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `is_open_enrollment` boolean — Is the company in Open Enrollment?
  - `open_enrollment_start_date` string — Open Enrollment start date.
  - `open_enrollment_end_date` string — Open Enrollment end date.
  - `teams` DtosTeamLink[] — All company teams.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `locations` DtosLocationLink[] — All company locations.
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `departments` DtosDepartmentLink[] — All company departments.
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `job_titles` DtosJobTitleLink[] — All company job titles.
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `plans` DtosPlansLink
    - `href` string, required — The object uri.
  - `employees` DtosEmployeeLinks
    - `href` string, required — The object uri.
  - `total_employees_count` integer — The total count of employees.
  - `active_employees_count` integer — The count of active employees.
  - `codes` object — A key value store of custom codes for this company.
  - `last_modified_date` string, required
  - `create_date` string, required
  - `status` 'Active' | 'Inactive' | 'Demo' | 'Migrating' — The status of the company.
  - `client_admins` DtosEmployeeLink[] — A list of the employees designated as client admins.
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `benefits_signatory` DtosEmployeeLink
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.
  - `producers` DtosAgentLink[] — A list of the broker contacts designated as producers.
    - `name` string, required — The name of the object.
    - `id` string, required — The object id.
    - `href` string, required — The object uri.

## Other responses

- `403` — Forbidden
- `410` — Gone

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)