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

Workday Time Off API

Endpoints for managing time-off requests and entries.

Workday Time Off API is one of 50 APIs that Workday publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 5 JSON Schema definitions.

Tagged areas include Time Off. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, authentication docs, and 5 JSON Schemas.

This API exposes 3 operations across 3 paths, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://wd2-impl-services1.workday.com/ccx/api/absenceManagement/v1/{tenant}.

3 operations 3 paths 5 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://wd2-impl-services1.workday.com/ccx/api/
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Workday Time Off API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

Paths & Operations 3

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

Time Off 3

Endpoints for managing time-off requests and entries.

POST
/workers/{ID}/requestTimeOff
Request Time Off
requestTimeOff 1 param body → 201400401404
GET
/workers/{ID}/timeOffEntries
Get Time Off Entries
getTimeOffEntries 5 params → 200401404
GET
/workers/{ID}/timeOffBalances
Get Time Off Balances
getTimeOffBalances 3 params → 200401404

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are TimeOffEntry (7 properties), TimeOffBalance (6 properties), ResourceReference (3 properties), ErrorResponse (2 properties). Each schema is shown below with its type and property counts.

TimeOffEntry
object
7 properties
ErrorResponse
object
2 properties
TimeOffBalance
object
6 properties
ResourceReference
object
3 properties
TimeOffRequest
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-time-off-api-openapi.yml Raw ↑

Other APIs Workday publishes across the network.

Workday Strategic Sourcing API
Workday SOAP Web Services API
Workday Extend API
Workday Adaptive Planning API
Workday Absence Types API
Workday Accounting API
Workday Benefit Elections API
Workday Benefit Plans API
Workday Candidates API
Workday Compensation Plans API
Workday Contact Information API
Workday Data Change Tasks API