/positions Permission level: 7

get/positions

Request

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

Query parameters

permsinteger

enum[1] -> 1: Show perms

updated_atstring date

DateTime in ISO8601 format. <br> Retrieves only positions that were updated <strong>after</strong> the date and time provided with this parameter.

include_deletedinteger

enum[0,1] -> 0: Do not Include deleted positions; 1: Include deleted positions. It has to be used in conjunction with 'updated_at' parameter.

Response

200

statusinteger
tokenstring

Example response

{
  "status": 1,
  "data": [
    {
      "id": 1321636,
      "name": "Desk Service",
      "start_time": {
        "id": 1,
        "time": "12 am"
      },
      "end_time": {
        "id": 97,
        "time": "midnight"
      },
      "color": 11,
      "ical": "https://www.humanity.shiftplanning.com/ical/-89ec2cc0b3e7ef6e44095846bd6d2e8e.ics?1470147114000",
      "visible": 1,
      "notify": 1
    }
  ],
  "token": "xxxxxxx"
}

Changes