HomeGuidesAPI Reference
API Reference

Get availability in date period

post
https://www.humanity.com/api/v2/employees/availability

/employees/availability

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Prerequisite

  • Availability must be enabled in settings

Overview

  • Returns availability slots for provided date range by role permission

Limitations

  • Maximum range for fetching availability is 1 month
  • Deleted availability is not fetched

Permission level access

  • Manager (can get data for all Employees)
  • Supervisor (can get data for all Employees)
  • Scheduler (can get data only for Employees holding Positions that Scheduler manages)
  • Employee (can get only their own data)
Query Params
string
required

xxxxxxxxxxxxx

Form Data
string
required

DateTime in ISO 8601 format, example: 2020-05-15T00:00:00-05:00

string
required

DateTime in ISO 8601 format, example: 2020-05-31T00:00:00-05:00

string
required

Comma separated values. Example:
4807410,1417042,2834065

int32

Pending - 0, Approved - 1, Rejected - 2

fields
object
Headers
string
required

application/x-www-form-urlencoded

Response

Updated 10 months ago

Language
Credentials
Query
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 10 months ago