Humanity Leave Types API
The Leave Types API from Humanity — 3 operation(s) for leave types.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/humanity:humanity-leave-types-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: default Leave Types API
version: '2.0'
servers:
- url: https://www.humanity.com/api/v2
security:
- sec0: []
tags:
- name: Leave Types
paths:
/leave-types/{leave_type}?access_token=xxxxxxx:
put:
summary: PUT Leave Type
description: '/leave-types/:id
Permission level: 7'
operationId: put-leave-type
parameters:
- name: id
in: path
description: Leave Type ID
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
allow_hourly:
type: boolean
days_booked_in_advance:
type: integer
format: int32
do_not_deduct:
type: boolean
max_num_at_once:
type: integer
format: int32
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\t\n\t\"stats\": 1, \n\t\"token\": \"31105252bbae716e014cb4653ff9f779cc44d8c7\",\n\t\"data\": \"Allow hourly leave type state changed.\"\n}"
schema:
type: object
properties:
stats:
type: integer
example: 1
default: 0
token:
type: string
example: 31105252bbae716e014cb4653ff9f779cc44d8c7
data:
type: string
example: Allow hourly leave type state changed.
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
x-readme:
code-samples:
- language: html
code: https://www.humanity.com/api/v2/leave-types/1234?access_token=xxxxxxx
samples-languages:
- html
tags:
- Leave Types
/leave-types?access_token=xxxxxxx:
get:
summary: GET Leave types
description: '/leaves
Permission level: 7'
operationId: get-leave-types-1
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"status\": 1,\n \"data\": [\n {\n \"id\": \"327926\",\n \"name\": \"Leave Test\",\n \"description\": \"asd\",\n \"allow_hourly\": \"1\",\n \"max_num_of_staff_at_once\": null,\n \"days_booked_in_advance\": null,\n \"entitled\": 21,\n \"created_at\": \"2017-09-21 07:11:08\",\n \"created_by\": \"3475050\",\n \"updated_at\": \"2017-09-24 21:05:32\",\n \"updated_by\": \"3475050\",\n \"deleted_at\": null,\n \"deleted_by\": null\n },\n {\n \"id\": \"327924\",\n \"name\": \"Leave Test 2\",\n \"description\": \"asdas\",\n \"allow_hourly\": \"0\",\n \"max_num_of_staff_at_once\": null,\n \"days_booked_in_advance\": null,\n \"entitled\": 12,\n \"created_at\": \"2017-09-21 07:10:48\",\n \"created_by\": \"3475050\",\n \"updated_at\": \"2017-09-24 21:05:38\",\n \"updated_by\": \"3475050\",\n \"deleted_at\": null,\n \"deleted_by\": null\n },\n {\n \"id\": \"327925\",\n \"name\": \"Leave Test 3\",\n \"description\": \"11\",\n \"allow_hourly\": \"1\",\n \"max_num_of_staff_at_once\": null,\n \"days_booked_in_advance\": null,\n \"entitled\": 12,\n \"created_at\": \"2017-09-21 07:10:59\",\n \"created_by\": \"3475050\",\n \"updated_at\": \"2017-09-24 21:05:43\",\n \"updated_by\": \"3475050\",\n \"deleted_at\": null,\n \"deleted_by\": null\n },\n {\n \"id\": \"326594\",\n \"name\": \"Sick leave\",\n \"description\": \"boles\",\n \"allow_hourly\": \"1\",\n \"max_num_of_staff_at_once\": 12,\n \"days_booked_in_advance\": null,\n \"entitled\": 12,\n \"created_at\": \"2017-09-14 14:28:06\",\n \"created_by\": \"3475050\",\n \"updated_at\": \"2017-09-24 21:06:09\",\n \"updated_by\": \"3475050\",\n \"deleted_at\": null,\n \"deleted_by\": null\n },\n {\n \"id\": \"315263\",\n \"name\": \"Vacation\",\n \"description\": null,\n \"allow_hourly\": \"0\",\n \"max_num_of_staff_at_once\": null,\n \"days_booked_in_advance\": null,\n \"entitled\": 20,\n \"created_at\": \"2017-07-10 13:25:56\",\n \"created_by\": \"3475050\",\n \"updated_at\": \"2017-09-13 07:39:38\",\n \"updated_by\": \"3475050\",\n \"deleted_at\": null,\n \"deleted_by\": null\n }\n ],\n \"token\": \"xxxxxxx\",\n \"error\": null\n}"
schema:
type: object
properties:
status:
type: integer
example: 1
default: 0
data:
type: array
items:
type: object
properties:
id:
type: string
example: '327926'
name:
type: string
example: Leave Test
description:
type: string
example: asd
allow_hourly:
type: string
example: '1'
max_num_of_staff_at_once: {}
days_booked_in_advance: {}
entitled:
type: integer
example: 21
default: 0
created_at:
type: string
example: '2017-09-21 07:11:08'
created_by:
type: string
example: '3475050'
updated_at:
type: string
example: '2017-09-24 21:05:32'
updated_by:
type: string
example: '3475050'
deleted_at: {}
deleted_by: {}
token:
type: string
example: xxxxxxx
error: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
x-readme:
code-samples:
- language: text
code: https://www.humanity.com/api/v2/leave-types?access_token=xxxxxxx
samples-languages:
- text
tags:
- Leave Types
/leave-types?access_token={{token}}:
post:
summary: POST Leave type
description: 'Permission Level: 5'
operationId: post-leave-types
requestBody:
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
max_num_at_once:
type: integer
description: Limits maximum number of staff that can be booked at once
format: int32
days_booked_in_advanc:
type: integer
description: Sets how many days the leave has to be booked in advance
format: int32
allow_hourly:
type: integer
description: Can be 0 and 1 - if set to 0 this leave type can only have full day request, if set to 1 it will allow hourly leave requests
format: int32
entitled:
type: integer
description: Maximum number of days for this leave type
format: int32
title:
type: string
description: Title of the leave type
description:
type: string
description: Leave type description
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"status\": 1,\n \"data\": {\n \"id\": \"328497\",\n \"name\": \"Leave Type API TEST\",\n \"description\": \"Just a regular remote work\",\n \"allow_hourly\": \"1\",\n \"max_num_of_staff_at_once\": 2,\n \"days_booked_in_advance\": 5,\n \"entitled\": 22,\n \"created_at\": \"2017-09-24 21:23:09\",\n \"created_by\": 3475050,\n \"updated_at\": null,\n \"updated_by\": null,\n \"deleted_at\": null,\n \"deleted_by\": null\n },\n \"token\": \"xxxxxxx\",\n \"error\": null\n}"
schema:
type: object
properties:
status:
type: integer
example: 1
default: 0
data:
type: object
properties:
id:
type: string
example: '328497'
name:
type: string
example: Leave Type API TEST
description:
type: string
example: Just a regular remote work
allow_hourly:
type: string
example: '1'
max_num_of_staff_at_once:
type: integer
example: 2
default: 0
days_booked_in_advance:
type: integer
example: 5
default: 0
entitled:
type: integer
example: 22
default: 0
created_at:
type: string
example: '2017-09-24 21:23:09'
created_by:
type: integer
example: 3475050
default: 0
updated_at: {}
updated_by: {}
deleted_at: {}
deleted_by: {}
token:
type: string
example: xxxxxxx
error: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
x-readme:
code-samples:
- language: http
code: https://www.humanity.com/api/v2/leave-types?access_token=xxxxxxx
- language: text
code: "max_num_at_once=2\ndays_booked_in_advance=5\nallow_hourly=1\nentitled=22\ntitle=Leave Type API TEST \ndescription=Just a regular remote work"
name: 'BODY PARAMS:'
samples-languages:
- http
- text
tags:
- Leave Types
components:
securitySchemes:
sec0:
x-default: ''
type: apiKey
name: access_token
in: query
x-readme-fauxas: true
x-provenance:
method: searched
source: https://platform.humanity.com/reference
harvested: '2026-10-14'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://platform.humanity.com/reference/approve-availability.md
- https://platform.humanity.com/reference/approve-series.md
- https://platform.humanity.com/reference/create-availability-series.md
- https://platform.humanity.com/reference/create-datapoints.md
- https://platform.humanity.com/reference/create-driver.md
- https://platform.humanity.com/reference/create-master-tasks.md
- https://platform.humanity.com/reference/create-single-availability.md
- https://platform.humanity.com/reference/create-skill-expiration-data.md
- https://platform.humanity.com/reference/delete-availability.md
- https://platform.humanity.com/reference/delete-custom-field.md
- https://platform.humanity.com/reference/delete-datapoint.md
- https://platform.humanity.com/reference/delete-driver.md
- https://platform.humanity.com/reference/delete-employee-position.md
- https://platform.humanity.com/reference/delete-employee.md
- https://platform.humanity.com/reference/delete-forecastdatatype-by-unique_id.md
- https://platform.humanity.com/reference/delete-forecastdatatypes.md
- https://platform.humanity.com/reference/delete-future-availability.md
- https://platform.humanity.com/reference/delete-leave-type.md
- https://platform.humanity.com/reference/delete-leave.md
- https://platform.humanity.com/reference/delete-location.md
- https://platform.humanity.com/reference/delete-master-tasks.md
- https://platform.humanity.com/reference/delete-message.md
- https://platform.humanity.com/reference/delete-note.md
- https://platform.humanity.com/reference/delete-nottice.md
- https://platform.humanity.com/reference/delete-position-break-rules.md
- https://platform.humanity.com/reference/delete-position.md
- https://platform.humanity.com/reference/delete-ratecards.md
- https://platform.humanity.com/reference/delete-shift-breaks.md
- https://platform.humanity.com/reference/delete-shift.md
- https://platform.humanity.com/reference/delete-shifts-approve.md
- https://platform.humanity.com/reference/delete-skill.md
- https://platform.humanity.com/reference/delete-timeclock-event.md
- https://platform.humanity.com/reference/delete-timeclock-location.md
- https://platform.humanity.com/reference/delete-timeclock-terminal.md
- https://platform.humanity.com/reference/delete-timeclock.md
- https://platform.humanity.com/reference/delete-training-module.md
- https://platform.humanity.com/reference/delete-training-section.md
- https://platform.humanity.com/reference/delete-wall-message.md
- https://platform.humanity.com/reference/delete-weekly-availability.md
- https://platform.humanity.com/reference/get-availability-approve.md
- https://platform.humanity.com/reference/get-availability-by-series.md
- https://platform.humanity.com/reference/get-availability-in-date-period.md
- https://platform.humanity.com/reference/get-billing-packages.md
- https://platform.humanity.com/reference/get-budget.md
- https://platform.humanity.com/reference/get-business.md
- https://platform.humanity.com/reference/get-clear.md
- https://platform.humanity.com/reference/get-companies.md
- https://platform.humanity.com/reference/get-company-settings.md
- https://platform.humanity.com/reference/get-company.md
- https://platform.humanity.com/reference/get-custom-field.md
- https://platform.humanity.com/reference/get-custom-fields.md
- https://platform.humanity.com/reference/get-custom-report.md
- https://platform.humanity.com/reference/get-daily-peak-hours-report.md
- https://platform.humanity.com/reference/get-data-points.md
- https://platform.humanity.com/reference/get-datapoint-by-datapoints-unique-id.md
- https://platform.humanity.com/reference/get-datapoint.md
- https://platform.humanity.com/reference/get-datapoints.md
- https://platform.humanity.com/reference/get-driver.md
- https://platform.humanity.com/reference/get-drivers-from-company.md
- https://platform.humanity.com/reference/get-employee-by-eid.md
- https://platform.humanity.com/reference/get-employee-by-employee-id-copy.md
- https://platform.humanity.com/reference/get-employee-manage-positions.md
- https://platform.humanity.com/reference/get-employee-position.md
- https://platform.humanity.com/reference/get-employee-report.md
- https://platform.humanity.com/reference/get-employee-tasks.md
- https://platform.humanity.com/reference/get-employee.md
- https://platform.humanity.com/reference/get-employees-positions.md
- https://platform.humanity.com/reference/get-employees-preclockin.md
- https://platform.humanity.com/reference/get-employees.md
- https://platform.humanity.com/reference/get-forecast-datatypes.md
- https://platform.humanity.com/reference/get-forecastdatatype-by-unique_id.md
- https://platform.humanity.com/reference/get-forecastdatatype.md
- https://platform.humanity.com/reference/get-future-availability.md
- https://platform.humanity.com/reference/get-group-permisions.md
- https://platform.humanity.com/reference/get-group-reports.md
- https://platform.humanity.com/reference/get-leave-types-1.md
- https://platform.humanity.com/reference/get-leave-types-for-a-specific-employee.md
- https://platform.humanity.com/reference/get-leave.md
- https://platform.humanity.com/reference/get-leaves.md
- https://platform.humanity.com/reference/get-location.md
- https://platform.humanity.com/reference/get-locations.md
- https://platform.humanity.com/reference/get-master-tasks.md
- https://platform.humanity.com/reference/get-me.md
- https://platform.humanity.com/reference/get-message.md
- https://platform.humanity.com/reference/get-messages.md
- https://platform.humanity.com/reference/get-multiple.md
- https://platform.humanity.com/reference/get-note.md
- https://platform.humanity.com/reference/get-notes.md
- https://platform.humanity.com/reference/get-notices.md
- https://platform.humanity.com/reference/get-nottice.md
- https://platform.humanity.com/reference/get-number-of-requests.md
- https://platform.humanity.com/reference/get-onnow.md
- https://platform.humanity.com/reference/get-payroll-report.md
- https://platform.humanity.com/reference/get-position-breakrules.md
- https://platform.humanity.com/reference/get-position.md
- https://platform.humanity.com/reference/get-positions.md
- https://platform.humanity.com/reference/get-preclockins.md
- https://platform.humanity.com/reference/get-publish.md
- https://platform.humanity.com/reference/get-ratecard.md
- https://platform.humanity.com/reference/get-ratecards.md
- https://platform.humanity.com/reference/get-schedule-report.md
- https://platform.humanity.com/reference/get-shift-breaks.md
- https://platform.humanity.com/reference/get-shift-tasks.md
- https://platform.humanity.com/reference/get-shift.md
- https://platform.humanity.com/reference/get-shifts-approve.md
- https://platform.humanity.com/reference/get-shifts.md
- https://platform.humanity.com/reference/get-single-availability-slot.md
- https://platform.humanity.com/reference/get-skill.md
- https://platform.humanity.com/reference/get-skills.md
- https://platform.humanity.com/reference/get-swap.md
- https://platform.humanity.com/reference/get-timeclock-event.md
- https://platform.humanity.com/reference/get-timeclock-location.md
- https://platform.humanity.com/reference/get-timeclock-status.md
- https://platform.humanity.com/reference/get-timeclock-terminal.md
- https://platform.humanity.com/reference/get-timeclock.md
- https://platform.humanity.com/reference/get-timeclocks-terminal.md
- https://platform.humanity.com/reference/get-timeclocks.md
- https://platform.humanity.com/reference/get-timesheets-report.md
- https://platform.humanity.com/reference/get-trade.md
- https://platform.humanity.com/reference/get-trades.md
- https://platform.humanity.com/reference/get-training-module-comments.md
- https://platform.humanity.com/reference/get-training-module-signature.md
- https://platform.humanity.com/reference/get-training-module.md
- https://platform.humanity.com/reference/get-training-modules.md
- https://platform.humanity.com/reference/get-training-progress.md
- https://platform.humanity.com/reference/get-training-section.md
- https://platform.humanity.com/reference/get-training-sections.md
- https://platform.humanity.com/reference/get-wall-messages.md
- https://platform.humanity.com/reference/get-weekly-availability.md
- https://platform.humanity.com/reference/get-workunits-daily-report.md
- https://platform.humanity.com/reference/post-add-clock-time.md
- https://platform.humanity.com/reference/post-availability-approve.md
- https://platform.humanity.com/reference/post-budget.md
- https://platform.humanity.com/reference/post-copy-datapoints-by-datatype-unique-id.md
- https://platform.humanity.com/reference/post-copy-datapoints.md
- https://platform.humanity.com/reference/post-custom-fields.md
- https://platform.humanity.com/reference/post-datapoint.md
- https://platform.humanity.com/reference/post-employee-clockin.md
- https://platform.humanity.com/reference/post-employee-manage-positions.md
- https://platform.humanity.com/reference/post-employee-position.md
- https://platform.humanity.com/reference/post-employee.md
- https://platform.humanity.com/reference/post-employees-preclockin.md
- https://platform.humanity.com/reference/post-forecastdatatypes.md
- https://platform.humanity.com/reference/post-future-availability.md
- https://platform.humanity.com/reference/post-leave-request-all-day.md
- https://platform.humanity.com/reference/post-leave-request-hourly.md
- https://platform.humanity.com/reference/post-leave-types.md
- https://platform.humanity.com/reference/post-location.md
- https://platform.humanity.com/reference/post-message.md
- https://platform.humanity.com/reference/post-note.md
- https://platform.humanity.com/reference/post-nottice.md
- https://platform.humanity.com/reference/post-position-break-rules.md
- https://platform.humanity.com/reference/post-position.md
- https://platform.humanity.com/reference/post-save-note.md
- https://platform.humanity.com/reference/post-shift-breaks.md
- https://platform.humanity.com/reference/post-shift.md
- https://platform.humanity.com/reference/post-shifts-approve.md
- https://platform.humanity.com/reference/post-skills.md
- https://platform.humanity.com/reference/post-timeclock-event.md
- https://platform.humanity.com/reference/post-timeclock-location.md
- https://platform.humanity.com/reference/post-timeclock-terminal-clockout.md
- https://platform.humanity.com/reference/post-timeclock-terminal-login.md
- https://platform.humanity.com/reference/post-timeclock-terminal.md
- https://platform.humanity.com/reference/post-timeclocks.md
- https://platform.humanity.com/reference/post-trade.md
- https://platform.humanity.com/reference/post-training-modules.md
- https://platform.humanity.com/reference/post-training-section.md
- https://platform.humanity.com/reference/post-wall-message.md
- https://platform.humanity.com/reference/put-approving-leave-request.md
- https://platform.humanity.com/reference/put-availability-approve.md
- https://platform.humanity.com/reference/put-company-settings.md
- https://platform.humanity.com/reference/put-custom-fields.md
- https://platform.humanity.com/reference/put-datapoint-by-the-datatype-unique-id.md
- https://platform.humanity.com/reference/put-datapoint.md
- https://platform.humanity.com/reference/put-employee-clockout.md
- https://platform.humanity.com/reference/put-employee-position.md
- https://platform.humanity.com/reference/put-employee.md
- https://platform.humanity.com/reference/put-enablingdisabling-leave-types-for-employees.md
- https://platform.humanity.com/reference/put-forecastdatatypes-by-unique-id-copy.md
- https://platform.humanity.com/reference/put-forecastdatatypes-by-unique-id.md
- https://platform.humanity.com/reference/put-forecastdatatypes.md
- https://platform.humanity.com/reference/put-future-availability.md
- https://platform.humanity.com/reference/put-leave-type.md
- https://platform.humanity.com/reference/put-leaves.md
- https://platform.humanity.com/reference/put-location.md
- https://platform.humanity.com/reference/put-manage-time-clock-1.md
- https://platform.humanity.com/reference/put-manage-time-clock.md
- https://platform.humanity.com/reference/put-note.md
- https://platform.humanity.com/reference/put-nottice.md
- https://platform.humanity.com/reference/put-position.md
- https://platform.humanity.com/reference/put-ratecards.md
- https://platform.humanity.com/reference/put-rejecting-leave-request.md
- https://platform.humanity.com/reference/put-shift-breaks.md
- https://platform.humanity.com/reference/put-shift.md
- https://platform.humanity.com/reference/put-shifts-approve.md
- https://platform.humanity.com/reference/put-skill.md
- https://platform.humanity.com/reference/put-swap.md
- https://platform.humanity.com/reference/put-timeclock-event.md
- https://platform.humanity.com/reference/put-timeclock-terminal.md
- https://platform.humanity.com/reference/put-timeclocks.md
- https://platform.humanity.com/reference/put-trade.md
- https://platform.humanity.com/reference/put-training-module-comments.md
- https://platform.humanity.com/reference/put-training-module-complete.md
- https://platform.humanity.com/reference/put-training-module.md
- https://platform.humanity.com/reference/put-training-section-sync.md
- https://platform.humanity.com/reference/put-training-section.md
- https://platform.humanity.com/reference/put-wall-message.md
- https://platform.humanity.com/reference/put-weekly-availability.md
- https://platform.humanity.com/reference/reject-availability.md
- https://platform.humanity.com/reference/timeclock-terminal-clockin.md
- https://platform.humanity.com/reference/update-data-points.md
- https://platform.humanity.com/reference/update-employee-task.md
- https://platform.humanity.com/reference/update-employee-tasks.md
- https://platform.humanity.com/reference/update-master-tasks.md
merge:
pages: 214
deduped: 217
conflicts_kept_first: 0