Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho People Leave API

Leave types, balances, and request lifecycle.

Zoho People Leave API is one of 7 APIs that Zoho People publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Leave. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a JSON-LD context, rate-limit docs, and 1 JSON Schema.

This API exposes 4 operations across 4 paths, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 8 base URLs: https://people.zoho.com/people/api, https://people.zoho.eu/people/api, https://people.zoho.in/people/api, https://people.zoho.com.au/people/api, https://people.zoho.jp/people/api, https://people.zoho.com.cn/people/api, https://people.zohocloud.ca/people/api, https://people.zoho.sa/people/api.

4 operations 4 paths 1 schemas 3 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://people.zoho.com/people/api
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho People Leave API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (ZohoOAuth2) using the authorizationCode flow, exposing 13 scopes. By default, every request must be authenticated.

  • ZohoOAuth2 — Zoho Accounts OAuth 2.0 — Authorization Code grant. Access tokens live for 1 hour; refresh tokens are long-lived until revoked. Scope syntax is ZOHOPEOPLE. . w…

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Leave 4

Leave types, balances, and request lifecycle.

GET
/leave/getHolidays
List Holidays
listHolidays 2 params → 200
GET
/leave/getLeaveTypeDetails
List Leave Types
listLeaveTypes 1 param → 200
POST
/forms/leave/insertRecord
Apply For Leave
applyForLeave body → 200
GET
/forms/leave/getRecords
List Leave Requests
listLeaveRequests 1 param → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is LeaveType (6 properties). Each schema is shown below with its type and property counts.

LeaveType
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-people-leave-api-openapi.yml Raw ↑

Other APIs Zoho People publishes across the network.

Zoho People Attendance API
Zoho People Automation API
Zoho People Dashboard API
Zoho People Employee API
Zoho People Forms API
Zoho People Time Tracker API