---
title: "PUT Employee clockout"
method: PUT
path: "/employees/{id}/clockout"
---

# PUT Employee clockout

`PUT /employees/{id}/clockout`

## Request

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

/employees/:id/clockout
Permission level: 5

## Path parameters

- `id` integer, required

## Request body `application/x-www-form-urlencoded`

- object
  - `schedule` integer
  - `notes` string
  - `photo` string: eg.{"large":"timeclock/pic_250834.135402.jpg", "small":"timeclock/sm_250834.135402.jpg","tiny":"timeclock/ti_250834.135402.jpg"}
  - `location` string: Clock in localtion - IP adress
  - `clock_out_time` string: time (eg. "Mar 11, 2015 01:33am") by default it is the current timestamp
  - `latitude` string
  - `longitude` string
  - `tips` string

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` string
    - `store` string
    - `status` string
    - `schedule` unknown
    - `notes` string
    - `created` string
    - `in_timestamp` string
    - `in_day` string
    - `out_timestamp` string
    - `out_day` string
    - `in_hour` string
    - `out_hour` string
    - `in_location` string
    - `out_location` string
    - `in_terminal` string
    - `out_terminal` string
    - `approved_by` string
    - `approved_time` string
    - `approved_notes` string
    - `in_picture` unknown
    - `out_picture` string
    - `screenshots` unknown
    - `break_time` string
    - `start_timestamp` string
    - `end_timestamp` string
    - `in_picture_url` string
    - `out_picture_url` unknown
    - `in_gps` string
    - `out_gps` string
    - `in_distance` unknown
    - `out_distance` unknown
    - `unique_id` unknown
    - `created_at` string
    - `updated_at` string
    - `deleted_at` unknown
    - `created_by` unknown
    - `updated_by` unknown
    - `deleted_by` unknown
    - `shift` unknown
    - `employee` object
      - `id` string
      - `name` string
    - `in_time` object
      - `time` string
      - `day` string
      - `timestamp` string
    - `start` object
      - `id` integer
      - `month` integer
      - `day` integer
      - `wday` integer
      - `year` integer
      - `weekday` string
      - `mname` string
      - `week` integer
      - `dayid` integer
      - `timeid` integer
      - `timeid_exact` integer
      - `formatted` string
      - `iso8601` string
      - `time` string
      - `timestamp` integer
      - `hours` integer
      - `minutes` integer
      - `seconds` integer
      - `date` string
      - `day_of_year` string
      - `week_adjusted` integer
      - `sp_wday` integer
    - `length` object
      - `hours` integer
      - `mins` integer
      - `total_hours` string
    - `out_time` object
      - `time` string
      - `day` string
      - `timestamp` string
    - `end` object
      - `id` integer
      - `month` integer
      - `day` integer
      - `wday` integer
      - `year` integer
      - `weekday` string
      - `mname` string
      - `week` integer
      - `dayid` integer
      - `timeid` integer
      - `timeid_exact` integer
      - `formatted` string
      - `iso8601` string
      - `time` string
      - `timestamp` integer
      - `hours` integer
      - `minutes` integer
      - `seconds` integer
      - `date` string
      - `day_of_year` string
      - `week_adjusted` integer
      - `sp_wday` integer
    - `current_length` object
      - `hours` integer
      - `mins` integer
      - `total_hours` string
    - `events` object[]
      - `id` string
      - `type` string
      - `timestamp` string
      - `clock_time` string
      - `data` object
        - `tips` integer
  - `metadata` unknown[]
    - unknown
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/employees/:id/clockout/put.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)
