---
title: "GET Company"
method: GET
path: "/companies/{id}"
---

# GET Company

`GET /companies/{id}`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/companies/{id}`
- Auth: API key in query parameter `access_token`

/companies/:id
Permission level: 3

## Path parameters

- `id` integer, required

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` string
    - `name` string
    - `domain` string
    - `created` string
    - `language` string
    - `master` string
    - `parent` unknown
    - `is_parent` string
    - `franchise` string
    - `settings` object
      - `admin_past_edit` string
      - `book_days_off` string
      - `book_days_off_adv` string
      - `book_days_off_max` string
      - `confirm_trade_before` string
      - `confirm_trade_after` string
      - `sms` string
      - `email` string
      - `pm` string
      - `visible_staff` string
      - `visible_staff_details` string
      - `visible_coworkers` string
      - `trade_shifts` string
      - `coworkers_contacts` string
      - `future_avail` string
      - `weekly_avail` string
      - `visible_overview` string
      - `visible_own` string
      - `timeout` string
      - `message_wall_on` string
      - `message_wall_emp` string
      - `message_wall_comments` string
      - `message_wall_uploads` string
      - `on_now` string
      - `shift_confirm` string
      - `shift_drop` string
      - `shift_autoconfirm` string
      - `timeclock` string
      - `tc_terminal_lock` string
      - `tc_round_to` string
      - `tc_round_to_in` string
      - `tc_round_to_out` string
      - `tc_clock_in_timeframe` string
      - `tc_clock_out_timeframe` string
      - `tc_autoclockout` string
      - `tc_webcam` string
      - `tc_empl_import` string
      - `tc_empl_addtime` string
      - `tc_empl_edittime` string
      - `24hr` string
      - `draft` string
      - `date` string
      - `startday` string
      - `currency` string
      - `viewadvance` string
      - `login_splogo` string
      - `scosting` string
      - `start_day` string
      - `end_day` string
      - `start_time` string
      - `end_time` string
      - `overtime` string
      - `timezone` string
    - `admin` object
      - `id` string
      - `name` string
      - `email` string
    - `staff` object[]
      - `id` string
      - `name` string
    - `locations` object
      - `542311` string
    - `positions` object[]
      - `id` string
      - `name` string
      - `l_name` unknown
      - `l_id` unknown
  - `token` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/companies/:id/get.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
