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

# companies

`GET /v{version}/companies`

Returns the list of companies you have access to.<p>Scopes: export_company_info</p>

## Path parameters

- `version` string, required

## Query parameters

- `start_id` string
- `name` string
- `limit` integer

## Response `200`

Success

- 0PagedWrappedArrayCompany
  - `next_id` string — The id of the object next up after this set.
  - `data` DtosCompany[], required — An array containing the list of relevant objects.
    - `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.
  - `error` string — Contains any error messages, if applicable.

---

[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)