/timeclocks Permission level: 5

post/timeclocks

Request

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

Request body application/x-www-form-urlencoded

start_datestring date required
start_timestring date required
employeeinteger required
scheduleinteger
end_datestring date
end_timestring date
notesstring
tipsstring
in_locationstring

IP address

out_locationstring

IP address

Response

200

statusinteger
tokenstring
errorunknown

Example response

{
  "status": 1,
  "data": {
    "id": "101664178",
    "store": "343161",
    "status": "0",
    "notes": "note",
    "created": "1545826494",
    "in_timestamp": "1545804865",
    "in_day": "3528",
    "out_timestamp": "1545826465",
    "out_day": "3528",
    "in_hour": "30",
    "out_hour": "54",
    "in_location": "Website",
    "out_location": "Website",
    "in_terminal": "0",
    "out_terminal": "-98",
    "approved_by": "3999372",
    "approved_time": "1545826494",
    "approved_notes": "autoapproved",
    "break_time": "0",
    "start_timestamp": "2018-12-26 07:14:25",
    "end_timestamp": "2018-12-26 13:14:25",
    "created_at": "2018-12-26 13:14:54",
    "updated_at": "2018-12-26 13:14:54",
    "employee": {
      "id": "3999372",
      "name": "Alan Ford"
    },
    "in_time": {
      "time": "07:14",
      "day": "Dec 26, 2018",
      "timestamp": "2018-12-26 07:14:25"
    },
    "start": {
      "id": 3528,
      "month": 12,
      "day": 26,
      "wday": 3,
      "year": 2018,
      "weekday": "Wed",
      "mname": "Dec",
      "week": 52,
      "dayid": 4,
      "timeid": 30,
      "timeid_exact": 29,
      "formatted": "Dec 26, 2018",
      "iso8601": "2018-12-26T07:14:25+0100",
      "time": "07:14",
      "timestamp": 1545804865,
      "hours": 7,
      "minutes": 14,
      "seconds": 25,
      "date": "2018-12-26 07:14:25",
      "day_of_year": "359",
      "week_adjusted": 52,
      "sp_wday": 4
    },
    "length": {
      "hours": 6,
      "total_hours": "6.00"
    },
    "out_time": {
      "time": "13:14",
      "day": "Dec 26, 2018",
      "timestamp": "2018-12-26 13:14:25"
    },
    "end": {
      "id": 3528,
      "month": 12,
      "day": 26,
      "wday": 3,
      "year": 2018,
      "weekday": "Wed",
      "mname": "Dec",
      "week": 52,
      "dayid": 4,
      "timeid": 54,
      "timeid_exact": 53,
      "formatted": "Dec 26, 2018",
      "iso8601": "2018-12-26T13:14:25+0100",
      "time": "13:14",
      "timestamp": 1545826465,
      "hours": 13,
      "minutes": 14,
      "seconds": 25,
      "date": "2018-12-26 13:14:25",
      "day_of_year": "359",
      "week_adjusted": 52,
      "sp_wday": 4
    },
    "current_length": {
      "hours": 6,
      "total_hours": "6.01"
    },
    "events": [
      {
        "id": "146780033",
        "type": "3",
        "timestamp": "2018-12-26 13:14:25",
        "clock_time": "101664178",
        "data": {
          "notes": "note"
        }
      }
    ]
  },
  "token": "e75a561fbf7b291d0058f505f5563e115d49bce9"
}

Changes