PUT Employee clockout

Changed on

/employees/:id/clockout Permission level: 5

put/employees/{id}/clockout

Request

  • Base URL
    https://www.humanity.com/api/v2
  • Auth
    API key in query parameter access_token

Path parameters

idinteger required

employee id

Request body application/x-www-form-urlencoded

scheduleinteger
notesstring
photostring

eg.{"large":"timeclock/pic_250834.135402.jpg", "small":"timeclock/sm_250834.135402.jpg","tiny":"timeclock/ti_250834.135402.jpg"}

locationstring

Clock in localtion - IP adress

clock_out_timestring

time (eg. "Mar 11, 2015 01:33am") by default it is the current timestamp

latitudestring
longitudestring
tipsstring

Response

200

statusinteger
tokenstring
errorunknown

Example response

{
  "status": 1,
  "data": {
    "id": "101708341",
    "store": "343161",
    "status": "0",
    "notes": "goodbye",
    "created": "1545862939",
    "in_timestamp": "1545813180",
    "in_day": "3528",
    "out_timestamp": "1545820380",
    "out_day": "3528",
    "in_hour": "39",
    "out_hour": "47",
    "in_location": "178.148.20.103",
    "out_location": "178.148.20.103",
    "in_terminal": "0",
    "out_terminal": "-98",
    "approved_by": "3999372",
    "approved_time": "1545862972",
    "approved_notes": "autoapproved",
    "break_time": "0",
    "start_timestamp": "2018-12-26 09:33:00",
    "end_timestamp": "2018-12-26 11:33:00",
    "in_gps": "{\"latitude\":\"\",\"longitude\":\"\",\"supported\":0}",
    "out_gps": "{\"latitude\":\"\",\"longitude\":\"\",\"supported\":0}",
    "created_at": "2018-12-26 23:22:19",
    "updated_at": "2018-12-26 23:22:52",
    "employee": {
      "id": "3999372",
      "name": "Alan Ford"
    },
    "in_time": {
      "time": "09:33",
      "day": "Dec 26, 2018",
      "timestamp": "2018-12-26 09:33:00"
    },
    "start": {
      "id": 3528,
      "month": 12,
      "day": 26,
      "wday": 3,
      "year": 2018,
      "weekday": "Wed",
      "mname": "Dec",
      "week": 52,
      "dayid": 4,
      "timeid": 39,
      "timeid_exact": 39,
      "formatted": "Dec 26, 2018",
      "iso8601": "2018-12-26T09:33:00+0100",
      "time": "09:33",
      "timestamp": 1545813180,
      "hours": 9,
      "minutes": 33,
      "date": "2018-12-26 09:33:00",
      "day_of_year": "359",
      "week_adjusted": 52,
      "sp_wday": 4
    },
    "length": {
      "hours": 2,
      "total_hours": "2.00"
    },
    "out_time": {
      "time": "11:33",
      "day": "Dec 26, 2018",
      "timestamp": "2018-12-26 11:33:00"
    },
    "end": {
      "id": 3528,
      "month": 12,
      "day": 26,
      "wday": 3,
      "year": 2018,
      "weekday": "Wed",
      "mname": "Dec",
      "week": 52,
      "dayid": 4,
      "timeid": 47,
      "timeid_exact": 47,
      "formatted": "Dec 26, 2018",
      "iso8601": "2018-12-26T11:33:00+0100",
      "time": "11:33",
      "timestamp": 1545820380,
      "hours": 11,
      "minutes": 33,
      "date": "2018-12-26 11:33:00",
      "day_of_year": "359",
      "week_adjusted": 52,
      "sp_wday": 4
    },
    "current_length": {
      "hours": 13,
      "mins": 50,
      "total_hours": "13.83"
    },
    "events": [
      {
        "id": "146845446",
        "type": "8",
        "timestamp": "2018-12-26 23:22:19",
        "clock_time": "101708341",
        "data": {
          "tips": 39
        }
      }
    ]
  },
  "token": "xxxxxxx"
}

Changes