Workforce Dimensions API

Introduction
The Workforce Dimensions platform provides a powerful application programming interface and documentation to help you develop
secure, scalable, and high-performance applications that leverage the full breadth of capabilities offered by our backend services.
The Workforce Dimensions suite’s API is founded on a pragmatic implementation of the representational state transfer architectural
style and allows access to your organization’s workforce data using common HTTP methods and the JSON interchange format.
Our extensible platform allows any application you build to access your workforce data, from a mobile companion app to a full-
featured client unique to your organization and its needs.

Organization
Each functional area within the suite is known as a domain. Domains are further divided into subgroups to organize API resources
into logical groupings. Some domains contain no subgroups. Others contain many.
Every domain contains resources, each of which represents a business entity that is stored or computed.
• Stored entities include punches, accrual balances, and shifts
• Computed entities include the schedule and the Attendance processor
Every resource is accessed using one or more operations, each of which consists of an HTTP method plus a URL.
While most domains focus on a specific functional area, Common Resources and Platform do not.
Common Resources contains resources shared by all domains, allowing you to access and manipulate general employee data, user
display profiles, business structures, the Control Center, the Transaction Assistant, and data aggregated across domains.
Platform consists of resources with supporting capabilities that are neutral to Workforce Management concepts.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Conceptual documentation
Conceptual documentation provides writer-crafted user guidance that introduces our API and provides a series of informative and
tutorial topics to get you started with the API as quickly as possible. This area of the Developer Portal also provides overviews of our
API, including our pragmatic implementation of the REST standard, and of our major domains.

API Reference Documentation

From here you may browse our library of API resources, organized hierarchically by domain, or major functional area, logical
subgroup, API resource, and all available operations against each resource.
• Attendance
• Common Resources
• Leave
• Platform
• Scheduling
• Timekeeping

Attendance
Attendance automates the process of tracking and enforcing the types of policies that might typically be found in an employee
handbook. Missing a punch, being absent, punching in or out too early or too late, or consistently taking longer breaks than allowed
are all common examples of the types of employee policies Attendance can be configured to support.
Attendance works with rules and policies. For example, if an employee is absent three times in a month, your policy might state such
an employee is then on probation. A fourth absence in that time period could result in a final warning, and a fifth in termination.
Attendance automates the enforcement of such rules in a very configurable way.
• Actions
• Attendance Audit Records
• Balance Adjustments
• Balance Expirations
• Balance Resets
• Balances
• Discipline Levels
• Events

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

• Markers
• Perfect Attendance
• Perfect Attendance Deductions
• Processor Requests
• Profile Assignments
• Rules

Actions
This resource allows you to view and manipulate Attendance Actions, which are a configured list of entities that each represent an
Attendance consequence.
Actions in Attendance are symbolic. They represent an informational flag to a human being informing him or her that they need to go
do something, such as a manager delivering a verbal warning to an employee. Actions are an output of the Attendance Processor.
An Action Definition refers to configuration, while an Action Transaction refers to the output of the Attendance Processor.

HTTP
Operation Method URL Endpoint Description
Complete Actions POST /v1/attendance/actions/complete Completes actions for one or more
employees.
Retrieve Action GET /v1/attendance/actions/{id}/documents Returns all documents associated with an
Documents by ID action.
Retrieve Action by ID GET /v1/attendance/actions/{id} Returns information about an action.
Retrieve Actions’ POST /v1/attendance/actions/documents/multi_read Returns all documents associated with a
Documents group of actions.
Retrieve Multiple Actions POST /v1/attendance/actions/multi_read Returns all or only the required actions for
multiple employees.
Update Action by ID POST /v1/attendance/actions/{id} Updates an action’s completion date and
user note.

Attendance Audit Records

This resource allows you to access auditing records for the Attendance domain.
Operation HTTP URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 Method
Retrieve Attendance POST /v1/attendance/audit_records/multi_read Returns auditing records for auditing entities and
Audit Records employees within a date range.

Balance Adjustments
This resource allows you to retrieve, update, and delete adjustments to an employee’s balances.
In Attendance, balance adjustments are measured in terms of points or time.

HTTP
Operation Method URL Endpoint Description
Bulk Update and Return POST /v1/attendance/balance_adjustments/multi_update Updates balances for employees
Balances for multiple balance types.
Mark Balance Adjustments POST /v1/attendance/balance_adjustments/{id}/mark_deleted Marks point balance adjustments
for Deletion by ID for deletion.
Retrieve Balance POST /v1/attendance/balance_adjustments/multi_read Returns point balance
Adjustments adjustments.
Update and Return POST /v1/attendance/balance_adjustments Updates balances for employees.
Balances

Balance Expirations
This resource allows you to access information about an employee’s expiring balances.
In Attendance, balances are measured in terms of points or time.

HTTP
Operation Method URL Endpoint Description
Retrieve Expiring POST /v1/attendance/balance_expirations/multi_read Returns expiring points for
Balances employees.

Balance Resets
This resource allows you to delete, reset, and retrieve resets to an employee’s balances.
In Attendance, balance resets are measured in terms of points or time.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Bulk Reset Balances POST /v1/attendance/balance_resets/multi_update Resets balances for employees for
multiple balance types.
Mark Balance Resets for POST /v1/attendance/balance_resets/{id}/mark_deleted Marks point balance resets for
Deletion by ID deletion.
Reset Balances POST /v1/attendance/balance_resets Resets balances for employees.
Retrieve Balance Resets POST /v1/attendance/balance_resets/multi_read Returns point balance resets for
employees.

Balances

This resource allows you to access information about an employee’s balances.

In Attendance, balances are measured in terms of points or time.

Operation HTTP Method URL Endpoint Description

Retrieve Balances POST /v1/attendance/balances/multi_read Returns point balance summaries for employees.

Discipline Levels
This resource allows you to access information about discipline levels, which are configurable entities in Attendance through which
you can group a set of policies in an Attendance profile.
When a profile is assigned to an employee, that employee can be in only one discipline level at any point of time.

Operation HTTP Method URL Endpoint Description

Retrieve Discipline Levels POST /v1/attendance/discipline_levels/multi_read Returns discipline levels for employees.

Events
This resource allows you to access Events, a basic component of Attendance.
Attendance Events determine which data imported from Timekeeping is significant to your organization’s policies. Each Event maps
to one of the elements Attendance consumes from Timekeeping. Events can map to input from outside the suite as well. For
example, a company might choose to track traffic violations for employees who drive company trucks. Events are input for the series
of Attendance rules enforced by all active policies.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Create Events POST /v1/attendance/events/multi_create Creates events for one or more employees.
Delete Event by ID DELETE /v1/attendance/events/{id} Deletes a basic event.
Mark Event as Deleted by POST /v1/attendance/events/{id}/mark_deleted Marks an event as deleted.
ID
Retrieve Event Types GET /v1/attendance/events/types Returns a list of event types.
Retrieve Event by ID GET /v1/attendance/events/{type}/{id} Returns an event.
Retrieve Events POST /v1/attendance/events/multi_read Returns events.
Retrieve Events by Action GET /v1/attendance/events Returns events that resulted in a specified
action.
Update Event by ID POST /v1/attendance/events/{id} Updates an event.

Markers
This resource allows you to create, retrieve, and delete markers, which represent dates that influence the functionality of the
Attendance Processor.

HTTP
Operation Method URL Endpoint Description
Create or Update POST /v1/attendance/markers/multi_create Creates or updates Ignore History Markers or Ignore
Ignore Markers Timecard Markers for employees.
Remove Ignore POST /v1/attendance/markers/multi_delete Removes Ignore History Markers or Ignore Timecard
Markers Markers for employees.
Retrieve Markers POST /v1/attendance/markers/multi_read Returns history and Timecard data markers.

Perfect Attendance
This resource allows you to access Perfect Attendance transactions.
As Discipline Levels measure violations of acceptable behavior, Perfect Attendance provides a way to measure and reward an
employee’s good behavior.

Operation HTTP URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 Method
Retrieve Perfect Attendance POST /v1/attendance/perfect_attendance/multi_read Returns Perfect Attendance awards
Transactions and violations.

Perfect Attendance Deductions

This resource allows you to access Perfect Attendance deductions.
As Discipline Levels measure violations of acceptable behavior, Perfect Attendance provides a way to measure and reward an
employee’s good behavior.

HTTP
Operation Method URL Endpoint Description
Retrieve Perfect Attendance POST /v1/attendance/perfect_attendance_deductions/multi_read Returns Perfect Attendance
Deductions deductions.

Processor Requests
This resource allows you to create, retrieve, update, and delete scheduled requests for the Attendance Processor.
The Attendance Processor is responsible for extracting data from Timekeeping as well as enforcing the rules that are defined within
Attendance Policies. The Attendance Processor runs at defined points in an organization’s workflow.

HTTP
Operation Method URL Endpoint Description
Create Attendance Processor POST /v1/attendance/processor_requests Creates an Attendance Processor
Request request.
Delete Attendance Processor DELETE /v1/attendance/processor_requests/{id} Deletes an Attendance Processor
Request by ID request.
Retrieve Attendance Processor GET /v1/attendance/processor_requests/{id} Returns an Attendance Processor
Request by ID request.
Retrieve Attendance Processor GET /v1/attendance/processor_requests Returns all Attendance Processor
Requests requests.
Update Attendance Processor PUT /v1/attendance/processor_requests/{id} Updates an Attendance Processor
Request by ID request.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Profile Assignments
This resource allows you to peform general Attendance transactions, such as retrieving Attendance profile assignments for a group
of employees within a date range.

HTTP
Operation Method URL Endpoint Description
Retrieve Profile POST /v1/attendance/profiles_assignments/multi_read Returns profile assignments for
Assignments employees.

Rules
This resource allows you to execute Attendance rules.
Rules in Attendance always evaluate to true or false when executed and serve as the building blocks of Attendance policies. An
Attendance consequence occurs for each rule that is evaluated as false.

Operation HTTP Method URL Endpoint Description

Execute Attendance Rules for Employees POST /v1/attendance/rules/execute Executes rules for employees.

Common Resources
Common Resources are resources shared by all domains, allowing you to access and manipulate general employee data, user
display profiles, business structures, the Control Center, the Transaction Assistant, and data aggregated across domains.
• Business Structures
• Cost Center
• Display Profiles
• Employee Group
• Entitlements
• Hyperfind
• Information Access
• Labor Category
• Labor Category Entry
• Labor Category List
• Labor Category List Assignment

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

• Labor Category Profile
• Licensing
• Locale Settings
• Messaging Notifications
• Pay Period Timespans
• People
• Symbolic Periods
• Time Zone

Business Structures
Business structures, also known as organizational maps, enable you to define a hierarchical structure for your organization using
types, locations, and jobs.
A business structure defines trees containing nodes that represent these three components. Types represent logical organizational
levels in your enterprise. Locations represent a physical location or a logistical unit that is not a physical location. Jobs represent
roles with fixed responsibilities.

Business Structures > Jobs

This resource provides a set of operations that allow you to create, read, update, and delete jobs.
Jobs are roles that have a fixed responsibility (Registered Nurse, Associate, Welder). Jobs are attached to locations on the business
structure that represent locations where employees actually perform those jobs.

HTTP
Operation Method URL Endpoint Description
Create Generic Job POST /v1/commons/jobs Creates a generic job.
Delete Generic Job DELETE /v1/commons/jobs Deletes a generic job.
Delete Generic Job by ID DELETE /v1/commons/jobs/{jobId} Deletes a generic job.
Retrieve Effective Job by ID GET /v1/commons/jobs/{jobId} Returns an effective job.
Retrieve Effective Job by Name GET /v1/commons/jobs Returns an effective job by name.
Retrieve Generic Jobs by Job POST /v1/commons/jobs/apply_read Returns generic jobs by job assignment (job
Assignment node).
Retrieve Generic Jobs by Reference POST /v1/commons/jobs/multi_read Returns generic jobs by reference.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Update Generic Job by ID POST /v1/commons/jobs/{jobId} Updates a generic job.

Business Structures > Location Sets

This resource provides a set of operations that allow you to create, read, and update location sets.
Locations, which each represent a physical location (Operating Room or Mail Room) or a logistical unit that is not a physical location
(Support, Administration, a Home Care Unit), can be grouped into sets.

HTTP
Operation Method URL Endpoint Description
Create Location Set POST /v1/commons/location_sets Creates a location set.
Retrieve Location Set by ID GET /v1/commons/location_sets/{id} Returns a location set by ID.
Retrieve Location Set by GET /v1/commons/location_sets Returns a location set by name and
Name system.
Retrieve Location Sets by List POST /v1/commons/location_sets/multi_read Returns location sets.
Update Location Set by ID POST /v1/commons/location_sets/{groupId} Updates a location set.

Business Structures > Location Types

This resource provides a set of operations that allow you to create, read, update, and delete location types.
Location types are logical organizational levels in your enterprise, such as region, division, store, area, and department.

HTTP
Operation Method URL Endpoint Description
Create Location Type POST /v1/commons/location_types Creates a location type.
Delete Location Type DELETE /v1/commons/location_types Deletes a location type.
Delete Location Type by ID DELETE /v1/commons/location_types/{id} Deletes a location type.
Retrieve Location Type by ID GET /v1/commons/location_types/{id} Returns location (node) type
information.
Retrieve Location Types by POST /v1/commons/location_types/multi_read Returns location (node) types.
Context
Retrieve Location Types by POST /v1/commons/location_types/apply_read Returns location (node) types by
Location location.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Location Types by GET /v1/commons/location_types Returns location (node) types.
Name
Update Location Type by ID POST /v1/commons/location_types/{id} Updates a location type.

Business Structures > Locations

Locations can be a physical location (Operating Room or Mail Room) or a logistical unit that is not a physical location (Support,
Administration, a Home Care Unit). You can use the operations associated with this resource to create, update, delete, and view
locations.

HTTP
Operation Method URL Endpoint Description
Copy Location POST /v1/commons/locations/apply_create Copies Organizational Map location
information.
Create Location Node POST /v1/commons/locations Creates an Organizational Map location
node.
Create Locations POST /v1/commons/locations/multi_create Creates Organizational Map locations.
Create Locations POST /v1/commons/locations/multi_create/async Creates Organizational Map locations
Asynchronously asynchronously.
Delete Locations POST /v1/commons/locations/multi_delete Deletes Organizational Map locations.
Move Location POST /v1/commons/locations/apply_update Moves Organizational Map location
information.
Retrieve Location by ID GET /v1/commons/locations/{id} Returns Organizational Map location (node)
information by ID.
Retrieve Location by Path GET /v1/commons/locations Returns Organizational Map location
information.
Retrieve Locations POST /v1/commons/locations/multi_read Returns Organizational Map locations.
Update Location POST /v1/commons/locations/{id} Updates an Organizational Map location.
Update Locations POST /v1/commons/locations/multi_update Updates Organizational Map locations.

Cost Center
This resource allows you to add, delete, or change cost center objects.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

The cost center is an attribute on the business structure that allows work to be charged to the company’s General Ledger.
When a cost center is assigned to a location, an employee’s work inherits the cost center when the employee works in that location.
Otherwise, cost centers are inherited from the parent. If a cost center is not associated with any parent, then the cost center from the
lowest location level of the employee’s primary job is used.
You can also assign time to a specific cost center, for example when you need to charge work to the cost center of the employee’s
primary job or to another paying cost center.

HTTP
Operation Method URL Endpoint Description
Create Cost Centers POST /v1/commons/cost_centers/multi_create Creates a list of cost centers.
Delete Cost Centers POST /v1/commons/cost_centers/multi_delete Deletes a list of cost centers.
Retrieve Cost Center by GET /v1/commons/cost_centers/{id} Returns the requested cost center.
ID
Retrieve Cost Centers GET /v1/commons/cost_centers Returns a list of all cost centers in the
system.
Update Cost Centers POST /v1/commons/cost_centers/multi_update Updates a list of cost centers.

Display Profiles
The Display Profiles resource provides a set of operations that allow you to access user display profiles.

Operation HTTP Method URL Endpoint Description

Retrieve Display Profile by ID GET /v1/commons/display_profiles/{id} Returns a display profile by ID.
Retrieve Display Profile by References POST /v1/commons/display_profiles/multi_read Returns a list of display profiles.
Retrieve Display Profiles GET /v1/commons/display_profiles Returns a list of display profiles.

Employee Group
The Employee Group resource allows you to add, delete, or change an employee group object within the system.

HTTP
Operation Method URL Endpoint Description
Create employee groups POST /v1/commons/employee_groups/multi_create This operation creates a list of employee
groups.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Employee Group GET /v1/commons/employee_groups/{id} This operation returns the requested
by its identifier employee group.
Retrieve Employee Groups GET /v1/commons/employee_groups This operation returns the list of
employee groups in the system.
Update Employee Groups POST /v1/commons/employee_groups/multi_update This operation updates a list of employee
groups.

Entitlements
This resource helps to fetch the entitlement’s summary and history details.

Operation HTTP Method URL Endpoint Description

Entitlement History GET /v1/licensing/entitlement_history Returns the entitlement history details.
Entitlement Summary GET /v1/licensing/entitlement_summary Returns the entitlements for all the license-packages.

Hyperfind

The Hyperfind domain provides operations that allow you to retrieve a list of employees based on predefined conditions.

Hyperfind > Hyperfind Queries Execution

Executes specified hyperfind query

HTTP
Operation Method URL Endpoint Description
Execute hyperfind query POST /v1/commons/hyperfind/execute Executes a Hyperfind query and returns the
result.
Retrieve All Hyperfind Queries GET /v1/commons/hyperfind Returns a list of Hyperfind queries accessible to
the user.
Retrieve only Public Hyperfind GET /v1/commons/hyperfind/public Returns a list of public Hyperfind queries.
Queries

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Information Access
The Information Access domain provides programmatic access to data from various sources in a manner similar to the way a
database is accessed. The resources within this domain allow ad hoc queries, dynamic definition and execution of Data Views, and
access to the Data Dictionary.

Information Access > Aggregated Data

This resource represents collectively retrievable data from multiple sources: Timekeeping, Scheduling, Commons, and Key
Performance Indicators (KPIs). Operations on this resource use a powerful SQL-like syntax to query data. These queries include
complex filtering and reduction functions as well as grouping, sorting, and pagination options.

Operation HTTP Method URL Endpoint Description

Retrieve Aggregated Data POST /v1/commons/data/multi_read Returns aggregated employee or organization data.

Information Access > Data Dictionary

This resource allows you to create, update, activate, and deactivate Data Elements within the Data Dictionary.
The Data Dictionary is a collection of Data Elements from all domains in the suite. A particular set of Data Elements, known as Gold
Data Elements, are automatically loaded by the system and can be immediately used to create Dataviews.

HTTP
Operation Method URL Endpoint Description
Retrieve Data Element GET /v1/commons/data_dictionary/data_elements Returns a Data Element’s
Definitions definitions.
Retrieve Data Element POST /v1/commons/data_dictionary/data_elements/multi_read Returns a Data Element’s
Definitions by Keys definitions.
Retrieve Location Types GET /v1/commons/data_dictionary/location_types Returns Location Types.
Retrieve Metadata GET /v1/commons/data_dictionary/metadata Returns system-defined
metadata.

Information Access > Dataview Profiles

This resource allows you to create, read, delete, and manipulate profiles that control which Dataviews users are allowed to view and
the ways in which Dataviews are used.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Create Dataview Profile POST /v1/commons/dataview_profiles Creates a Dataview Profile.
Delete Dataview Profile by DELETE /v1/commons/dataview_profiles/{id} Deletes a Dataview Profile by ID.
ID
Retrieve Dataview Profile GET /v1/commons/dataview_profiles/{id} Returns a Dataview Profile by ID.
by ID
Retrieve Dataview Profiles GET /v1/commons/dataview_profiles Returns all Dataview Profiles or returns a named
Profile.
Update Dataview Profile by PUT /v1/commons/dataview_profiles/{id} Updates a Dataview Profile by ID.
ID

Information Access > Dataviews

This resource allows you to create, read, delete, and manipulate custom data sources that are modeled after the common database
concept of views. You can create a Dataview to pull together virtually any kind of data into a single view by selecting data elements
from the Data Dictionary and applying a filter to one or more of those elements. Dataviews are often used to retrieve the same kinds
of data multiple times, such as reusing a query, rather than for ad hoc data retrieval. A particular set of Dataviews, known as Gold
Dataviews, are automatically loaded by the system. Dataview operations use the user profile, and a particular user gains access to a
Dataview by means of a DataviewProfile, which has one or more associated Dataviews.

HTTP
Operation Method URL Endpoint Description
Create Administrator Dataview POST /v1/commons/dataviews Creates a new administrator
Dataview.
Create Personalized Dataview POST /v1/commons/dataviews/{id}/personalization Creates a new personalized
Dataview.
Delete Administrator Dataview by DELETE /v1/commons/dataviews/{id} Deletes an administrator Dataview.
ID
Delete Personalized Dataview by DELETE /v1/commons/dataviews/{id}/personalization Deletes a personalized Dataview.
ID
Retrieve Dataview by Criteria POST /v1/commons/dataviews/multi_read Returns a Dataview.
Retrieve Dataview by ID GET /v1/commons/dataviews/{id} Returns a Dataview.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Dataviews GET /v1/commons/dataviews Returns Dataviews.
Update Administrator Dataview PUT /v1/commons/dataviews/{id} Updates an administrator
by ID Dataview.
Update Personalized Dataview PUT /v1/commons/dataviews/{id}/personalization Updates a personalized Dataview.
by ID

Information Access > Home Pages

The Home Pages resource allows you to create, retrieve, update, and delete home pages, which are the first page users see when
they log in to the application’s user interface. This resource also provides mechanisms for personalizing home pages and restoring
home pages to default settings.

HTTP
Operation Method URL Endpoint Description
Create Home Page POST /v1/commons/home_pages Creates a home page with tile
assignments.
Delete Home Page by ID DELETE /v1/commons/home_pages/{id} Deletes a home page by ID.
Delete a Personalized DELETE /v1/commons/home_pages/{id}/personalization Deletes a personalized home page and
Home Page by ID restores it to a default state.
Personalize Home Page POST /v1/commons/home_pages/{id}/personalization Personalizes a home page by ID.
by ID
Retrieve Home Page by ID GET /v1/commons/home_pages/{id} Returns a home page by ID.
Retrieve Home Pages GET /v1/commons/home_pages Returns all home pages.
Update Home Page PUT /v1/commons/home_pages/{id} Updates a home page by ID.

Information Access > Tiles

The Tiles resource allows you to retrieve all administrator- and user-created tiles and cards.
Tiles provide access to important content about your employees and organization. They can appear on your home page as a visual
representation of a common task that you frequently perform, such as a current schedule or a timesheet. They can also appear as a
visualization of a metric, or other summarization, in the form of a pie chart or graph. You can show or hide tiles depending on what
aspect of your business you want to view.

Operation HTTP Method URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Tiles GET /v1/commons/tiles Returns all tiles.

Labor Category

The Labor Category resource allows you to add, delete, or change a labor category object within the system.

HTTP
Operation Method URL Endpoint Description
Create Labor Categories POST /v1/commons/labor_categories/multi_create This operation creates a list of labor
categories with the given details.
Delete Labor Categories POST /v1/commons/labor_categories/multi_delete This operation deletes a list of labor
categories as per request.
Retrieve Labor Categories GET /v1/commons/labor_categories This operation returns the list of labor
categories.
Retrieve Labor Category GET /v1/commons/labor_categories/{id} This operation returns the requested labor
by its identifier category.
Update Labor Categories POST /v1/commons/labor_categories/multi_update This operation updates a list of labor
categories as per request.

Labor Category Entry

The Labor Category Entry resource allows you to add, delete, or change a labor category object within the system.

HTTP
Operation Method URL Endpoint Description
Create Labor Category POST /v1/commons/labor_entries/multi_create This operation creates a list of labor category
Entries entries.
Delete Labor Category POST /v1/commons/labor_entries/multi_delete This operation deletes a list of labor category
Entries entries.
Delete Labor Category by DELETE /v1/commons/labor_entries/{id} This operation deletes the requested labor
ID category entry.
Retrieve Labor Category GET /v1/commons/labor_entries This operation returns the list of labor
Entries category entries in the system.
Retrieve Labor Category GET /v1/commons/labor_entries/{id} This operation returns the requested labor

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Entry by ID category entry.
Retrieve Labor Category GET /v1/commons/labor_entries/{entryName} This operation returns the requested labor
Entry by Name category entry.
Update Labor Category POST /v1/commons/labor_entries/multi_update This operation updates a list of labor
Entries category entries.

Labor Category List

The Labor Category List resource allows you to add, delete, or change a labor category list object within the system.

HTTP
Operation Method URL Endpoint Description
Create Labor POST /v1/commons/labor_category_lists/multi_create This operation creates a list of labor category
Category Lists lists. Labor category lists contain list of labor
category entries.
Delete Labor POST /v1/commons/labor_category_lists/multi_delete This operation deletes a list of labor category
Category Lists lists
Delete Labor DELETE /v1/commons/labor_category_lists/{id} This operation deletes the requested labor
Category List by ID category list
Retrieve Labor GET /v1/commons/labor_category_lists This operation returns the list of labor category
Category Lists lists in the system.
Retrieve Labor GET /v1/commons/labor_category_lists/{id} This operation returns the requested labor
Category List by ID category list
Update Labor POST /v1/commons/labor_category_lists/multi_update This operation updates a list of labor category
Category Lists lists

Labor Category List Assignment

The Labor Category List Assignment resource allows you to add, delete, or change a labor category list assignment assignment
object within the system. Labor Category List Assignments are the association between an organization node, a labor category and a
labor category list assignment.

HTTP
Operation Method URL Endpoint Description
Create Labor POST /v1/commons/labor_category_list_assignments/multi_create Creates a list of labor category

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Category List list assignments. Labor category
Assignments lists contain list of labor category
entries.
Delete Labor POST /v1/commons/labor_category_list_assignments/multi_delete Deletes a list of labor category
Category List list assignments
Assignments
Retrieve Labor POST /v1/commons/labor_category_list_assignments/multi_read Returns the list of labor category
Category List list assignments in the system.
Assignments
Update Labor POST /v1/commons/labor_category_list_assignments/multi_update Updates a list of labor category
Category List list assignments
Assignments
Delete Labor POST /v1/commons/labor_category_list_assignments/multi_delete/ids Deletes list assignments by ID.
Category List
Assignments by ID

Labor Category Profile

The Labor Category Profile resource allows you to add, delete, or change a labor category profile object within the system.

HTTP
Operation Method URL Endpoint Description
Create Labor Category POST /v1/commons/labor_category_profiles/multi_create Creates a list of labor category
Profiles profiles.
Delete Labor Category DELETE /v1/commons/labor_category_profiles Deletes a labor category profile.
Profiles
Delete Labor Category DELETE /v1/commons/labor_category_profiles/{id} Deletes a labor category profile
Profile by ID by ID.
Retrieve Labor Category GET /v1/commons/labor_category_profiles Returns a list of all labor category
Profiles profiles in the system.
Retrieve Labor Category GET /v1/commons/labor_category_profiles/{id} Returns a labor category profile
Profile by ID by ID.
Retrieve Labor Category GET /v1/commons/labor_category_profiles/current_user Returns the labor category profile
Profile for Current User for the current user.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Update Labor Category POST /v1/commons/labor_category_profiles/multi_update Updates a list of labor category
Profiles profiles.

Licensing
The Licensing domain allows you to provide license- and package-related information.

Locale Settings
The Locale Settings domain contains regional settings (language locale, date format, number format, and currency format) that can
be assigned as the tenant default or to individual users. The users’ settings take precedence over the default setting for the tenant.
Users see the user interface in the language and regional settings assigned to them in their locale policy. The locale policy is
assigned to users in People Information.

Locale Settings > Locale Policies

This resource allows you to create, retrieve, update, and delete locale policies. Local policies contain regional settings (language
locale, date format, number format, and currency format) that can be assigned as the tenant default or to individual users. The users’
settings take precedence over the default setting for the tenant. Users see the user interface in the language and regional settings
assigned to them in their locale policy. The locale policy is assigned to users in People Information.

HTTP
Operation Method URL Endpoint Description
Create Locale Policies POST /v1/commons/locale_policies/multi_create Creates locale policies.
Create Locale Policy POST /v1/commons/locale_policies Creates a locale policy.
Delete Locale Policies POST /v1/commons/locale_policies/multi_delete Deletes a list of locale policies.
Delete Locale Policy DELETE /v1/commons/locale_policies/{id} Deletes a locale policy.
by ID
Retrieve Locale Policy GET /v1/commons/locale_policies Returns a Locale Policy by name, display
name, or sdmKey.
Retrieve Locale Policy GET /v1/commons/locale_policies/{id} Returns a locale policy.
by ID
Retrieve Locales POST /v1/commons/locale_policies/multi_read Returns locales.
Set Default Locale POST /v1/commons/locale_policies/apply_update Sets the locale policy as default for a tenant.
Policy

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Update Locale Policies POST /v1/commons/locale_policies/multi_update Updates a list of locale policies.
Update Locale Policy POST /v1/commons/locale_policies/{id} Updates a locale policy.
by ID

Locale Settings > User Preferences

This resource allows you to retrieve user preferences by user or tenant.

HTTP
Operation Method URL Endpoint Description
Retrieve User Preferences for GET /v1/commons/user_preferences/locale_policy Returns user preferences for the
Current User current user or tenant.

Messaging Notifications
This resource allows you to send and retrieve common messaging notifications.

HTTP
Operation Method URL Endpoint Description
Delete Multiple Notifications POST /v1/commons/notifications/multi_delete Deletes a list of notifications.
Retrieve Control Center GET /v1/commons/notifications/config Returns the Control Center
Configuration configuration.
Retrieve Notification Count GET /v1/commons/notifications/count Returns a count of all notifications for a
user.
Retrieve Notification Details GET /v1/commons/notifications/{message_id} Returns notification details.
Retrieve Notifications GET /v1/commons/notifications Returns a list of notifications for a user.
Retrieve Notifications by Item ID GET /v1/commons/notifications/item Returns a list of notifications for a given
item ID.
Retrieve Notifications by Item POST /v1/commons/notifications/multi_read Returns a list of notifications for a list of
IDs item IDs.
Review Notifications by ID POST /v1/commons/notifications/multi_review Reviews a list of notifications by ID.

Pay Period Timespans

This operation returns the start and end dates and times for a pay period.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Retrieve Pay Period GET /v1/commons/pay_period Returns the start and end dates and times for a pay
Timespans period.

People
The People domain allows you to add records for a new person, delete records of a person, and retrieve or modify information about
a person. The Persons resource also supports bulk operations such as multi-create, read, update, and delete. GET operations
retrieve person data based on employee, Timekeeping, Scheduling, device, or accrual extensions. Criteria-based GET operations
retrieve multiple person records that match search criteria.

People > Person Assignments

The Person Assignments resources allow you to make assignments of system entities for one or more persons.

People > Person Assignments > Adjustment Rule Assignments

This resource allows you to assign Adjustment Rules to an employee. This assignment is effective dated.
Use Adjustment rules to change wages or to pay extra based on time entered in a timecard. Adjustments can be made based on
multiple labor accounts and selection criteria, such as a labor category or cost center, or both.

HTTP
Operation Method URL Endpoint Description
Assign Adjustment Rule POST /v1/commons/persons/adjustment_rule Assigns an Adjustment Rule to an
employee.
Assign Adjustment POST /v1/commons/persons/adjustment_rule/multi_create Assigns an employee adjustment rule
Rule—Multiple to one or more employees.
Employees
Delete Adjustment Rule DELETE /v1/commons/persons/adjustment_rule Deletes the assignment of an
adjustment rule to an employee.
Delete Adjustment POST /v1/commons/persons/adjustment_rule/multi_delete Deletes employee adjustment rule
Rule—Multiple assignments for one or more
Employees employees.
Retrieve Adjustment GET /v1/commons/persons/adjustment_rule Returns a list of an employee’s

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Rules by Person adjustment rule assignments.
Number
Retrieve All Adjustment GET /v1/commons/persons/adjustment_rule/multi_read Returns a list of all employee
Rules adjustment rule assignments.
Update Adjustment Rule PUT /v1/commons/persons/adjustment_rule Updates an adjustment rule assigned
to an employee.
Update Adjustment POST /v1/commons/persons/adjustment_rule/multi_update Updates the assignment of an
Rule—Multiple adjustment rule to one or more
Employees employees.

People > Person Assignments > Attendance Administrator Assignment

This resource allows you to create, retrieve, update, and delete the assignment of an administrator to an Attendance employee.
The employee passed in must be a valid Workforce Attendance employee. The administrator passed in must be a valid Workforce
Timekeeper manager.

HTTP
Operation Method URL Endpoint Description
Delete Attendance DELETE /v1/commons/persons/attendance_admin Deletes the assignment of an
Admin administrator to an Attendance
employee.
Delete Attendance POST /v1/commons/persons/attendance_admin/multi_delete Deletes the assignment of an
Admin—Multiple administrator to one or more
Employees Attendance employees.
Retrieve Attendance GET /v1/commons/persons/attendance_admin Returns the administrator assigned to
Admin by Person an Attendance employee.
Number
Retrieve Attendance POST /v1/commons/persons/attendance_admin/multi_read Returns the administrators assigned
Admin—Multiple to one or more Attendance
Employees employees.
Update Attendance PUT /v1/commons/persons/attendance_admin Updates the assignment of an
Admin administrator to an Attendance
employee.
Update Attendance POST /v1/commons/persons/attendance_admin/multi_update Updates (or adds) the assignment of

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Admin—Multiple an administrator to one or more
Employees Attendance employees.

People > Person Assignments > Attendance Profiles

This resource allows you to assign or modify the assignment of Attendance profiles to employees.
Attendance profiles contain attendance policies and control the order in which the system processes the policies and their associated
rules.
All employees who have Attendance product licenses assigned are automatically assigned to the empty Attendance profile. This
profile is effective dated from the beginning of time until the end of time. After you have created Attendance policies and profiles,
assign the employees to the Attendance profiles that you have created.
An employee can be assigned to only one Attendance profile at a time.

HTTP
Operation Method URL Endpoint Description
Retrieve Attendance GET /v1/commons/persons/attendance_profile Returns an Attendance profile
Profile by Person Number assignment.
Retrieve Attendance POST /v1/commons/persons/attendance_profile/multi_read Returns Attendance profile
Profile—Multiple assignments for one or more
Employees employees.
Update Attendance Profile PUT /v1/commons/persons/attendance_profile Updates an attendance profile
assignment for an employee.
Update Attendance POST /v1/commons/persons/attendance_profile/multi_update Updates Attendance profile
Profile—Multiple assignments for one or more
Employees employees.

People > Person Assignments > Cascade Profile Assignment

This resource allows you to assign a cascade profile to an employee.
Cascading profiles contain cascading policies, which define the paycodes used to trigger cascading accrual takings. Employees can
have one or more policies in their profile, which is assigned by Accruals and Leave in People Information.

Operation HTTP URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 Method
Assign Cascade Profile PUT /v1/commons/persons/cascade_profile Assigns a cascade profile to an
employee.
Assign Cascade Profiles— POST /v1/commons/persons/cascade_profile/multi_update Assigns one or more cascade
Multiple Employees profiles to one or more employees.
Delete Cascade Profile DELETE /v1/commons/persons/cascade_profile Deletes a cascade profile
assignment.
Delete Cascade Profiles— POST /v1/commons/persons/cascade_profile/multi_delete Deletes the assignment of one or
Multiple Employees more cascade profiles.
Retrieve Cascade Profiles GET /v1/commons/persons/cascade_profile Returns cascade profile
by Person Number assignments for an employee.
Retrieve Cascade POST /v1/commons/persons/cascade_profile/multi_read Returns cascade profile
Profiles—Multiple assignments for one or more
Employees employees.

People > Person Assignments > Employee Job Preferences

This resource allows you to retrieve and update the job preferences associated with an employee.

HTTP
Operation Method URL Endpoint Description
Retrieve Job Preferences by GET /v1/commons/persons/job_preferences Returns employee job
Person Number preferences.
Retrieve Job Preferences— POST /v1/commons/persons/job_preferences/multi_read Returns job preferences for one
Multiple Employees or more employees.
Update Job Preferences PUT /v1/commons/persons/job_preferences Updates job preferences.
Update Job Preferences— POST /v1/commons/persons/job_preferences/multi_update Updates the job preferences for
Multiple Employees one or more employees.

People > Person Assignments > Leave Administrator Assignment

This resource allows you to create, retrieve, update, and delete the assignment of an administrator to a Leave employee.
The employee passed in must be a valid Workforce Leave employee. The administrator passed in must be a valid Workforce
Timekeeper manager.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Delete Leave Admin DELETE /v1/commons/persons/leave_admin Deletes the assignment of an
administrator to a Leave employee.
Delete Leave Admin— POST /v1/commons/persons/leave_admin/multi_delete Deletes the assignment of an
Multiple Employees administrator to one or more Leave
employees.
Retrieve Leave Admin GET /v1/commons/persons/leave_admin Returns the administrator assigned to a
by Person Number Leave employee.
Retrieve Leave POST /v1/commons/persons/leave_admin/multi_read Returns the administrators assigned to
Admin—Multiple one or more Leave employees.
Employees
Update Leave Admin PUT /v1/commons/persons/leave_admin Updates the assignment of an
administrator to a Leave employee.
Update Leave Admin— POST /v1/commons/persons/leave_admin/multi_update Updates (or adds) the assignment of an
Multiple Employees administrator to one or more Leave
employees.

People > Person Assignments > Leave Profile Assignment

This resource allows you to retrieve, update, and delete the Leave profile assignment associated with an employee.

HTTP
Operation Method URL Endpoint Description
Delete Leave Profile DELETE /v1/commons/persons/leave_profile Deletes the assignment of a Leave
profile to an employee.
Delete Leave Profile— POST /v1/commons/persons/leave_profile/multi_delete Deletes the assignment of a Leave
Multiple Employees profile to one or more employees.
Retrieve Leave Profile by GET /v1/commons/persons/leave_profile Returns the Leave profile assigned to
Person Number an employee.
Retrieve Leave Profile— POST /v1/commons/persons/leave_profile/multi_read Returns the Leave profiles assigned to
Multiple Employees one or more employees.
Update Leave Profile PUT /v1/commons/persons/leave_profile Updates the assignment of a Leave
profile to an employee.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Update Leave Profile— POST /v1/commons/persons/leave_profile/multi_update Updates the assignment of a Leave
Multiple Employees profile to one or more employees.

People > Person Assignments > Person Common ID

This resource allows you access to the PersonCommonId entity, which defines an Object Identifier for an employee.

This entity is a unique key that is used to identify an object managed by the Registry, such as organizations and associates. Each
employee can have one unique AOID (Associate Identifier) along with a COID (Company Identifier) used for Single Sign-On (SSO).

HTTP
Operation Method URL Endpoint Description
Delete AOID and COID DELETE /v1/commons/persons/external_id Deletes AOID and COID assignments
for an employee.
Delete AOID and COID— POST /v1/commons/persons/external_id/multi_delete Deletes AOID and COID assignments
Multiple Employees for one or more employees.
Retrieve AOID and COID GET /v1/commons/persons/external_id Returns AOID and COID assignments
by Person Number for an employee.
Retrieve AOID and POST /v1/commons/persons/external_id/multi_read Returns AOID and COID assignments
COID—Multiple for one or more employees.
Employees
Update AOID and COID PUT /v1/commons/persons/external_id Updates (or adds) AOID and COID
assignments for an employee.
Update AOID and COID— POST /v1/commons/persons/external_id/multi_update Updates (or adds) AOID and COID
Multiple Employees assignments for one or more
employees.

People > Person Assignments > Process Profile Assignments

This resource allows you to retrieve and update the assignment of a process profile to an employee.
The employee passed in must be a valid Workforce employee. When assigning either a manager or an employee process profile to a
person, the profile assigned must be a valid profile for that employee.

HTTP
Operation Method URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Process Profile GET /v1/commons/persons/process_profiles Returns the process profile assigned
by Person Number to an employee.
Retrieve Process POST /v1/commons/persons/process_profiles/multi_read Returns the process profiles
Profiles—Multiple assigned to one or more employees.
Employees
Update Process Profile PUT /v1/commons/persons/process_profiles/update Updates the assignment of a
process profile to an employee.
Update Process Profile— POST /v1/commons/persons/process_profiles/multi_update Updates the assignment of a
Multiple Employees process profile to one or more
employees.

People > Persons

This resource allows you to add a new person record, remove a person record, or view or edit information about a person.

HTTP
Operation Method URL Endpoint Description
Create Multiple Persons POST /v1/commons/persons/multi_create Creates person records.
Create Person POST /v1/commons/persons Creates a new person record.
Delete Multiple Persons POST /v1/commons/persons/multi_delete Deletes person records.
Delete Person by ID DELETE /v1/commons/persons/{personId} Deletes a person record.
Retrieve All Extensions GET /v1/commons/persons/extensions Returns a person record with all
extensions.
Retrieve Base Person POST /v1/commons/persons/base_persons/multi_read Returns base person information.
Retrieve Employee POST /v1/commons/persons/refs/multi_read Returns person records by search
References criteria.
Retrieve Person by GET /v1/commons/persons/{extensionType} Returns person records by extension.
Extension
Retrieve Person by ID GET /v1/commons/persons/{personId} Returns a person record.
Retrieve Persons POST /v1/commons/persons/extensions/multi_read Returns person records.
Update Multiple Persons POST /v1/commons/persons/multi_update Updates person records.
Update Person by ID PUT /v1/commons/persons/{personId} Updates a person record.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Update or Create Persons POST /v1/commons/persons/multi_upsert Updates or creates person records.

Symbolic Periods

This resource provides a set of operations that facilitate the set up of symbolic periods.

Symbolic periods allow employees to enter values such as full day, which translates into the number of hours in an employee’s shift.

HTTP
Operation Method URL Endpoint Description
Retrieve Date Span Grouped POST /v1/commons/symbolicperiod/multi_read Returns a map of date spans grouped
by Symbol Type by symbol type.
Retrieve Locale Date Span POST /v1/commons/symbolicperiod/read Returns a locale date span matching
the search criteria.
Retrieve Symbolic Period GET /v1/commons/symbolicperiod/period_types Returns all period types in the system.
Types
Retrieve Symbolic Periods GET /v1/commons/symbolicperiod Returns all symbolic periods in the
system.
Retrieve Symbolic Periods by GET /v1/commons/symbolicperiod/{periodTypeId} Returns a list of symbolic periods for a
Period Type ID given period type.

Time Zone
This resource allows you to set the system’s time zone.

Operation HTTP Method URL Endpoint Description

Set Timezone for Tenant PUT /v1/commons/timezones/apply_update Sets the timezone for a tenant.

Leave
Leave automates, streamlines, and standardizes the administration and enforcement of all leave policies, the incorrect enforcement
of which can put your organization at risk for costly fines and potential lawsuits. The functionality exposed by these resources allows
you to enforce leave rules consistently and fairly, and to maintain accurate and up-to-date records.
• Leave Audit Records
• Leave Case Certifications

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

• Leave Case Custom Fields
• Leave Case Defaults
• Leave Case Documents
• Leave Case Eligibility Requirements
• Leave Case Notes
• Leave Case Notifications
• Leave Case Rules
• Leave Cases
• Leave Custom Fields
• Leave Edits
• Leave Events
• Leave Request Configuration
• Leave Requests
• Leave Rules

Leave Audit Records

This resource allows you to access auditing records for the Leave domain.

HTTP
Operation Method URL Endpoint Description
Retrieve Leave Audit POST /v1/leave/audit_records/multi_read Returns auditing records for auditing entities and
Records employees within a date range.

Leave Case Certifications

This resource allows you to create and retrieve medical certifications associated with a Leave case. Frequency, duration, and
expiration date are parameters associated with medical certifications.

Operation HTTP Method URL Endpoint Description

Create Certification POST /v1/leave/leave_cases/certifications Creates a certification for a Leave case.
Retrieve Certification History GET /v1/leave/leave_cases/certifications Returns the certification history of a Leave case.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Leave Case Custom Fields
This resource allows you to retrieve and update custom fields associated with a Leave case. You can add an unlimited number of
custom fields to a case.

HTTP
Operation Method URL Endpoint Description
Retrieve Custom GET /v1/leave/leave_cases/custom_fields Returns custom field assignments for a
Fields Leave case.
Update Custom POST /v1/leave/leave_cases/custom_fields/multi_update Updates custom field values for a Leave
Fields case.

Leave Case Defaults

This resource allows you to retrieve and update Leave case defaults. Leave case defaults are used for actions such as adding Leave
time through group actions.

HTTP
Operation Method URL Endpoint Description
Retrieve Leave Case Defaults GET /v1/leave/leave_cases/defaults Returns details about Leave case
defaults.
Retrieve Leave Case Defaults by GET /v1/leave/leave_cases/{id}/defaults Returns details about Leave case
ID defaults.
Update Leave Case Defaults PUT /v1/leave/leave_cases/defaults Updates Leave case defaults.

Leave Case Documents

This resource allows you to retrieve, update, and generate documents associated with a Leave case.
The particular documents available within a Leave case is based on the Leave Types used in that case. Documents combine
templates with the details entered into a Leave case and can be generated as many times as necessary from within a Leave case. A
Doctor’s Note is a typical example of a Leave Case document. Regenerated documents do not replace older versions; they create a
new, dated copy that contains a fresh set of the case’s attributes.

Operation HTTP Method URL Endpoint Description

Generate Documents POST /v1/leave/leave_cases/documents/generate Generates documents for a Leave case.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Documents GET /v1/leave/leave_cases/documents Returns generated documents.
Update Documents POST /v1/leave/leave_cases/documents/multi_update Updates document attributes.

Leave Case Eligibility Requirements

This resource allows you to retrieve and update eligibility requirements for each Leave type. When a Leave type is selected on a
Leave case, eligibility requirements are checked against employee data.

HTTP
Operation Method URL Endpoint Description
Retrieve Eligibility GET /v1/leave/leave_cases/eligibility_requirements Returns a list of eligibility requirements for
Requirements a Leave case.
Update Eligibility POST /v1/leave/leave_cases/eligibility_requirements Updates eligibility requirements associated
Requirements with a Leave case.

Leave Case Notes

This resource allows you to create, retrieve, update, and delete Notes attached to Leave cases.

Operation HTTP Method URL Endpoint Description

Create Leave Case Note POST /v1/leave/leave_cases/notes Creates a Note for a Leave case.
Delete Leave Case Note by ID DELETE /v1/leave/leave_cases/notes/{id} Deletes a Note.
Retrieve Leave Case Note by ID GET /v1/leave/leave_cases/notes/{id} Returns a Note.
Retrieve Leave Case Notes GET /v1/leave/leave_cases/notes Returns a list of Notes for a Leave case.
Update Leave Case Note by ID POST /v1/leave/leave_cases/notes/{id} Updates a Note.

Leave Case Notifications

This resource allows you to activate, deactivate, copy, create, retrieve, update, and delete notifications configured for a Leave case.
Notifications have two types: limit-based notifications and date-based notifications. These notifications assist the Leave administrator
or the employee on the Leave case.

HTTP
Operation Method URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Activate Notification by ID POST /v1/leave/leave_cases/notifications/{id}/activate Activates a notification by ID.
Copy Notification by ID POST /v1/leave/leave_cases/notifications/{id}/copy Creates a copy of a notification by
ID.
Create Notification POST /v1/leave/leave_cases/notifications Creates a notification.
Deactivate Notification by POST /v1/leave/leave_cases/notifications/{id}/deactivate Deactivates a notification by ID.
ID
Delete Notification by ID DELETE /v1/leave/leave_cases/notifications/{id} Deletes a notification by ID.
Retrieve Notification by ID GET /v1/leave/leave_cases/notifications/{id} Returns a notification by ID.
Retrieve Notifications GET /v1/leave/leave_cases/notifications Returns a list of notifications.
Update Notification by ID POST /v1/leave/leave_cases/notifications/{id} Updates a notification by ID.

Leave Case Rules

This resource allows you to create, retrieve, update, and delete Leave Case rules, which describe the processing sequence for paid
and tracking time amounts. When a Leave case is assigned a rule, the status of the Leave case is changed to Open and you can
begin assigning Leave time.

HTTP
Operation Method URL Endpoint Description
Create Rule Assignment POST /v1/leave/leave_cases/case_rules Creates a rule assignment.
Delete Rule Assignment DELETE /v1/leave/leave_cases/case_rules/{id} Deletes a rule assignment.
Retrieve Rule Assignment GET /v1/leave/leave_cases/case_rules/{id} Returns a rule assignment for a Leave case
rule.
Retrieve Rule GET /v1/leave/leave_cases/case_rules Returns rule assignments.
Assignments
Update Rule Assignment POST /v1/leave/leave_cases/case_rules/{id} Updates a rule assignment.

Leave Cases
This resource allows you to view and manipulate Leave cases.
Leave cases are containers that capture data about a particular Leave case. The data captured within a Leave case includes notes,
notifications, frequency, and duration. Leave cases facilitate the administration of each leave of absence case. Each Leave case
belongs to and is associated with an employee. Leave cases are part of the core functionality of Leave.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Create Leave Case POST /v1/leave/leave_cases Creates a new Leave case.
Create Multiple Leave POST /v1/leave/leave_cases/multi_create Creates Leave cases.
cases
Delete Leave Case DELETE /v1/leave/leave_cases Deletes a Leave case.
Execute Grant Leave POST /v1/leave/leave_cases/grant Processes a grant leave request.
Retrieve Grant Data GET /v1/leave/leave_cases/grant_data Returns on-demand grant data.
Retrieve Leave Case GET /v1/leave/leave_cases Returns Leave case details.
Details
Retrieve Leave Case GET /v1/leave/leave_cases/{id} Returns Leave case details.
Details by ID
Retrieve Leave Cases POST /v1/leave/leave_cases/multi_read Returns Leave cases by IDs or for a list of
employees within a date range.
Retrieve Total Taking GET /v1/leave/leave_cases/total_taking Returns the total taking amount from grant accrual.
Amount
Update Leave Case PUT /v1/leave/leave_cases Updates a Leave case.

Leave Custom Fields

This resource allows you to retrieve Leave custom fields.

Operation HTTP Method URL Endpoint Description

Retrieve Leave Custom Fields by Type GET /v1/leave/custom_fields Returns Leave custom fields.

Leave Edits
This resource allows you to create, retrieve, or delete a Leave edit, which represents an instance of time that is charged against a
Leave case. Each Leave edit contains total paid and tracking amounts.

Operation HTTP Method URL Endpoint Description

Create Leave Edits POST /v1/leave/leave_edits Creates Leave edits.
Delete Leave Edits POST /v1/leave/leave_edits/multi_delete Deletes Leave edits.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Leave Edits POST /v1/leave/leave_edits/multi_read Returns Leave edits with total paid and tracking amounts.

Leave Events
This resource allows you to access Leave events for the Leave calendar. Such events are frequently created by Leave entities such
as cases or takings.

Operation HTTP Method URL Endpoint Description

Retrieve Leave Events POST /v1/leave/events Returns Leave events.

Leave Request Configuration

This resource allows you to retrieve configuration data associated with a Leave case. Such data includes Leave types in paid
segments, tracking segments, and eligibility questions. Data is retrieved based on an employee’s Leave profile, Leave category, and
reason.

HTTP
Operation Method URL Endpoint Description
Retrieve Leave Request GET /v1/leave/leave_request_configuration Returns configuration data for a
Configuration Leave request.
Retrieve Request GET /v1/leave/leave_request_configuration/request_subtypes Returns request subtypes.
Subtypes

Leave Requests
This resource allows you to create, read, and update (process) Leave case requests. The Leave request process begins when
employees request leave. Following the request, Leave routes requests to the appropriate approving managers.

HTTP
Operation Method URL Endpoint Description
Create Leave Case POST /v1/leave/leave_requests/multi_create Creates Leave case requests.
Requests
Create Leave Request POST /v1/leave/leave_requests Creates a Leave case request.
Process Leave Request POST /v1/leave/leave_requests/{id} Processes an existing request into a specified
by ID transition.
Process Leave Requests POST /v1/leave/leave_requests/multi_action Processes one or more existing requests into

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 specified transitions.
Retrieve Leave Case POST /v1/leave/leave_requests/multi_read Returns leave case requests.
Requests

Leave Rules
This resource describes the processing sequence for paid and tracking time amount. When a Leave case is assigned a rule, the
status of the Leave case is changed to Open and you can begin assigning Leave time.

Operation HTTP Method URL Endpoint Description

Retrieve Available Rules GET /v1/leave/rules Returns a list of available rules.

Platform
Platform comprises API resources with supporting capabilities that are neutral to Workforce Management concepts.
• Document Management
• Generic Notifications
• Integrations
• KPI Framework
• Reporting
• Timekeeping Setup Pay Rules
• Workflow

Document Management
The Document Management domain provides a set of resources and operations related to managing documents. This domain allows
you to retrieve, forward, and audit documents, manage document templates, and to retrieve tags associated with domains or
document templates.

Generic Notifications
This resource allows you to send and retrieve generic notifications.

HTTP
Operation Method URL Endpoint Description
Retrieve Generic GET /v1/platform/messaging/generic_notifications/{id} Returns details about a generic

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Notification by ID notification.
Retrieve Generic GET /v1/platform/messaging/generic_notifications Returns a list of all generic
Notifications notifications.
Send Notification by POST /v1/platform/messaging/generic_notifications/notify Sends a generic notification by
Event Type domain and event.
Send Notification by ID POST /v1/platform/messaging/generic_notifications/{id}/notify Sends a generic notification.

Integrations
Integrations exchange business and transactional data - such as person records, payroll data, punches, accruals balances, or
business structures - between applications.

Integrations > API integrations

This resource allows you to run integrations directly from the API to the data elements without the user interface.
API-based integrations do not use SFTP or flat files to pass the data, cannot be scheduled, and pass the data in the payload of the
REST API calls. The size of the data payload is limited, and the data is not transformed in any way. This type of integration is
synchronous, responses are detected quickly, and the status is updated immediately even if the integration fails or is blocked. Use
this type of integration when you must preserve the data without transformations, for example: import people, update punches, or
update accrual balances.

HTTP
Operation Method URL Endpoint Description
Execute API Integration by POST /v1/platform/api_integrations/execute/{key} Executes an API integration.
Key
Retrieve API Integration by GET /v1/platform/api_integrations/{key} Returns the details of an API integration.
Key
Retrieve API Integrations GET /v1/platform/api_integrations Returns a list of all API integrations.
Retrieve Integration Status GET /v1/platform/api_integrations/{id}/status Returns the execution status of an API
by ID integration.

Integrations > File-based Integrations

This resource allows you to run file-based integration processes.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

The payload is a flat file delivered by SFTP. You can run the integration from the Integration Hub user interface or with API calls. The
REST API calls do not carry the data. The amount of data is not limited, and the response time depends on the size of the file. These
integrations can transform or map the incoming or outgoing data, and can be run on-demand or be scheduled. Use this type of
integration for bulk updates or when you need to transform the data.

Operation HTTP Method URL Endpoint Description

Execute Integration by ID POST /v1/platform/integrations/{id}/execute Executes an integration.
Retrieve Integrations GET /v1/platform/integrations Returns all integrations.
Schedule Integration by ID POST /v1/platform/integrations/{id}/schedule Schedules an integration for execution.

Integrations > Integration Executions

This resource allows you to retrieve the details of on-demand and scheduled integration runs.
The execution data includes start date, completion date, parameters passed, status, and the ID of the person who initiated the run.

HTTP
Operation Method URL Endpoint Description
Retrieve All Integration GET /v1/platform/integration_executions Retrieves a list of all integration
Executions executions.
Retrieve Integration Execution by GET /v1/platform/integration_executions/{id} Returns an integration execution.
ID

Integrations > Integration Schedules

This resource allows you to retrieve the details of schedules that run integrations once or at recurring intervals.
The schedule data includes name, parameters passed, start date, end date, frequency, interval, and the next run.

HTTP
Operation Method URL Endpoint Description
Retrieve All Scheduled Integration GET /v1/platform/integration_schedules Returns a list of all scheduled integration
Instances instances.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

KPI Framework
The KPI domain provides operations that allow you to create and update Key Performance Indicators (KPIs) and metrics and retrieve
the computed values of KPIs or metrics.

Reporting
Reports enable you to organize information into an easy-to-read, easy-to-distribute file. With highly formatted and customizable
layouts, reports can be scheduled to run at regular intervals and managers can be notified when a report is available.
The Reporting domain provides operations that you can use to configure and run reports, assign reports into profiles, and assign
report profiles to people who can then run and schedule the reports. The current user can also track the run-report history and view
or delete executed reports.

Reporting > Publish and Run Reports

This resource allows you to publish report designs and run reports.
This resource provides details about required report parameters and metadata, including name, description, category, default output
type, and report paramaters. Only published reports are available to users based on their report profiles.

Operation HTTP Method URL Endpoint Description

Delete Report DELETE /v1/platform/reports/{id} Deletes a report.
Retrieve Published Reports GET /v1/platform/reports Returns all published reports.
Retrieve Report by ID GET /v1/platform/reports/{id} Returns a report.
Run Report by Name POST /v1/platform/reports/{name}/execute Runs a report.
Save Report POST /v1/platform/reports Saves a report.
Update Report by ID POST /v1/platform/reports/{id} Updates a report.

Reporting > Report Categories

This resource allows you to view the list of all report categories and report categories by name. Reports can be associated with
multiple report categories, and by default, each report is associated with ‘ALL’ report categories.

Operation HTTP Method URL Endpoint Description

Get All Report Categories GET /v1/platform/report_categories Returns all report categories.
Get Report Category By Name GET /v1/platform/report_categories/{name} Returns a report category.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Reporting > Report Data Objects
This resource allows you to view, add, delete, or edit report data objects. It saves the reporting data view and data object metadata,
and it publishes the data design to the reporting server.

HTTP
Operation Method URL Endpoint Description
Creates Reporting Data POST /v1/platform/report_dataobjects Creates new reporting data view, data
Object object meta data and data design file.
Delete Report Data DELETE /v1/platform/report_dataobjects/{dId} Deletes a reporting data view, data object
Object metadata and design file.
Get All Reporting Data GET /v1/platform/report_dataobjects Returns report data objects.
Objects
Get Data Elements POST /v1/platform/report_dataobjects/dataelements Returns data elements definition.
Definition
Get Data For Report POST /v1/platform/report_dataobjects/{name}/data Returns a reporting data response.
Data Object Name
Get Report Data Object GET /v1/platform/report_dataobjects/{id} Returns a report data object.
Update Report Data PUT /v1/platform/report_dataobjects/{id} Updates reporting data view, data object
Object meta data and data design file.

Reporting > Report Designs

This resource allows you to view all report design details and parameters. You can view report design parameters only for a single
report design.

HTTP
Operation Method URL Endpoint Description
Delete Unpublished Report Design DELETE /v1/platform/report_designs/{name} Deletes a report design.
by ID
Retrieve All Report Designs GET /v1/platform/report_designs Returns all report designs.
Retrieve Report Design GET /v1/platform/report_designs/{name}/parameters Returns report design
Parameters parameters.
Retrieve a Report Design by Name GET /v1/platform/report_designs/{name} Returns a report design.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Reporting > Report Executions
This resource allows you to view, add, delete, cancel, or edit a report run. Each run is recorded by an execution history for the
current user. This user can cancel in-progress report runs, view all successfully completed runs, and delete completed report runs.

Operation HTTP Method URL Endpoint Description

Retrieve Executed Report Output by ID GET /v1/platform/report_executions/{id}/file Returns a report as an attachment.
Retrieve Report History GET /v1/platform/report_executions Returns the report run history.

Reporting > Report Profiles

This resource allows you to view, add, delete, or edit report profiles. Users can access only those reports in their report profile. By
default, all published reports are associated with the ALL report profile.

Operation HTTP Method URL Endpoint Description

Create Report Profile POST /v1/platform/report_profiles Creates and saves a report profile.
Delete Report Profile by ID DELETE /v1/platform/report_profiles/{id} Deletes a report profile.
Retrieve All Report Profiles GET /v1/platform/report_profiles Returns all report profiles.
Retrieve Report Profile by ID GET /v1/platform/report_profiles/{id} Returns a report profile.
Update Report Profile by ID PUT /v1/platform/report_profiles/{id} Updates a report profile.

Reporting > Report Requests

This resource allows you to view, add, delete, or edit a report request.
Report requests can be scheduled to run once or recurrently. The current user can schedule only reports that are in their report
profiles. Users who have access to SCHEDULE REPORT FOR OTHERS can schedule reports on behalf of others. All recipients of a
schedule report request are notified in Control Center and can view the report and report execution history.

HTTP
Operation Method URL Endpoint Description
Create Report Request POST /v1/platform/scheduled_reports Creates and saves a new report
request.
Delete Report Request by ID DELETE /v1/platform/scheduled_reports/{id} Deletes a report request.
Retrieve Scheduled Report GET /v1/platform/scheduled_reports Returns all scheduled report requests.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Requests
Update Report Request by ID PUT /v1/platform/scheduled_reports/{id} Updates a report request.

Timekeeping Setup Pay Rules

This resource allows you to retrieve a list of pay rules.
Pay rules control how time and attendance information is processed for each employee. In a pay rule, your company defines how
each segment of time is marked. For example, pay rules allow you to define and record a normal pay period and an overtime period
inside a time segment.

Operation HTTP Method URL Endpoint Description

Retrieve Pay Rules GET /v1/timekeeping/setup/payrules Returns pay rules.

Scheduling
Conceptually, a schedule in the Workforce Management suite is tabular data with rows that refer to employees and columns that
refer to time units. Various entities and attributes are assigned to the cells in the table for the purpose of managing the employees’
time, with links to other parts of the system, notably Timekeeping, People, payroll, and accruals.
Scheduling makes it possible for different types of users to manage the schedule in different ways:
• A manager responsible for a set of employees can create, display, analyze, modify, and post the schedule for a specific period
of time, for those employees.
• An employee can display the employee’s own work schedule for a specific period, make requests for time off and receive
approval or rejection from the manager.
• A scheduling manager or a business analyst can establish rules that define and limit the interaction of the manager and the
employee.
• An IT professional or business analyst can automates the process of creating or modifying a schedule without violating the
Schedule rules.

• Availabilities
• Day Locks
• ESS Calendar Settings
• Employee Schedule Patterns
• Employee Schedules

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

• Employee Time Off Requests
• Employment Terms Paycode Edits
• Group Assignments
• Group Paycode Edits
• Group Schedule Patterns
• Group Schedules—Manager Access
• Group Shifts
• Leave Edits—Scheduling
• Manager Schedule Actions
• Manager Schedules
• Manager Time Off Requests
• Metrics—Scheduling
• Paycode Edits—Scheduling
• Procedure Set Engine
• Procedure Sets
• Request Submission Periods
• Rule Violations
• Schedule Audits
• Schedule Builder Settings
• Schedule Patterns
• Schedule Tags
• Shift Templates
• Shifts
• Tag Definitions
• Team Definitions
• Time Off Request Guided Recommendations
• Workload Coverage

Availabilities
This resource allows you to create, modify, and delete availabilities.
Availabilities are an element of the schedule which represent the desire or possibility of an employee to work at a given time. The
main availability characteristics are the date, the start and end times, and the assigned employee. Availabilities can be added,

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

deleted, or modified. Availabilities are made up of segments. There are various types of segment. Each segment has a start time and
an end time.

HTTP
Operation Method URL Endpoint Description
Create Availabilities by POST /v1/scheduling/schedule/availability/multi_update Creates or updates one or more
ID availabilities.
Create Availability POST /v1/scheduling/schedule/availability Creates or updates an availability.
Delete Availabilities DELETE /v1/scheduling/schedule/availability/multi_delete Deletes one or more availabilities.
Delete Availability by ID DELETE /v1/scheduling/schedule/availability Deletes an availability by employee and
date.
Retrieve Availability by GET /v1/scheduling/schedule/availability Returns an availability by employee and
ID date.

Day Locks
This resource allows a manager to lock one or more schedule days for one or more employees, preventing any add, delete, or
update of schedule entities on those days. This resource also allows the manager to remove such locks.

HTTP
Operation Method URL Endpoint Description
Lock Multiple Days POST /v1/scheduling/schedule/daylocks/apply_create Locks certain days for specified employees.
Unlock Multiple POST /v1/scheduling/schedule/daylocks/multi_delete Unlocks certain days for specified
Days employees.

ESS Calendar Settings

This resources allows a manager to create, retrieve, update, and delete Employee Self Service (ESS) Calendar Settings.

HTTP
Operation Method URL Endpoint Description
Create ESS Calendar POST /v1/scheduling/ess_calendar_settings Creates an ESS Calendar
Settings Settings.
Create Multiple ESS Calendar POST /v1/scheduling/ess_calendar_settings/multi_create Create a set of new ESS
Settings Calendar Settings.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Delete ESS Calendar DELETE /v1/scheduling/ess_calendar_settings/{id} Deletes an ESS Calendar
Settings by ID Settings.
Delete Multiple ESS Calendar POST /v1/scheduling/ess_calendar_settings/multi_delete Deletes one or more ESS
Settings Calendar Settings.
Retrieve ESS Calendar GET /v1/scheduling/ess_calendar_settings/{id} Returns ESS Calendar Settings.
Settings by ID
Retrieve ESS Calendar GET /v1/scheduling/ess_calendar_settings Returns an ESS Calendar
Settings by Name Settings.
Retrieve Multiple ESS POST /v1/scheduling/ess_calendar_settings/multi_read Returns one or more ESS
Calendar Settings Calendar Settings.
Update ESS Calendar PUT /v1/scheduling/ess_calendar_settings/{id} Updates an ESS Calendar
Settings Settings.
Update Multiple ESS PUT /v1/scheduling/ess_calendar_settings/multi_update Updates one or more ESS
Calendar Settings Calendar Settings.

Employee Schedule Patterns

This resource defines a repeating pattern of shifts and paycodes and assigns the pattern to an employee. Pattern assignments are
effective dated. Modifying the pattern assignment of an employee will automatically affect the schedule of that employee.
Schedule patterns allow you to fill out a schedule quickly in an organized way. Once you have defined and saved a pattern as a
Schedule template, you can assign it to any employee or group of employees.
Pattern Templates also make it possible to modify the schedule of a number of employees simultaneously by modifying the pattern
assigned to them.

HTTP
Operation Method URL Endpoint Description
Create Employee POST /v1/scheduling/employee_schedule_patterns/apply_create Creates an employee
Schedule Pattern schedule pattern.
Delete Employee DELETE /v1/scheduling/employee_schedule_patterns/{id} Deletes an employee
Schedule Pattern by ID schedule pattern.
Retrieve Builder GET /v1/scheduling/employee_schedule_patterns/builder Returns builder public
Configuration configuration data.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Employee GET /v1/scheduling/employee_schedule_patterns/{id} Returns an employee
Schedule Pattern by ID schedule pattern.
Retrieve Employee POST /v1/scheduling/employee_schedule_patterns/multi_read Returns one or more
Schedule Patterns employee schedule patterns.
Update Employee POST /v1/scheduling/employee_schedule_patterns/apply_update Updates multiple employee
Schedule Pattern schedule patterns.

Employee Schedules
This resource allows you to access the employee-restricted view of an employee schedule.
Only schedule entities for the user who is currently logged in can be viewed. The employee schedule contains the same entities as
the manager schedule, such as shifts, paycode edits, holidays, locked days, and shift transfers—but only for the current user. It also
contains detailed information about each entity in the schedule. The employee schedule does not support any editing actions.

HTTP
Operation Method URL Endpoint Description
Retrieve Employee GET /v1/scheduling/employee_schedule Returns an employee’s schedule according to the
Schedule specified parameters.

Employee Time Off Requests

This resource allows an employee to define and submit a request to be excused from regular work duties for different reasons.
If the request is approved, the system automatically incorporates the change in the schedule. All or portions of the employee’s shift
are replaced with the appropriate paycode. Different time-off subtypes require an open request submission period during which the
employee can submit the request, providing administrative control. Depending on configuration, the employee can request time off
for one day, a portion of a day, a symbolic portion of a day, multiple days or multiple portions or symbolic portions of days (whether in
sequence or not). All time off requests are linked to paycodes. Different submittal and approval criteria can be defined.

HTTP
Operation Method URL Endpoint Description
Create Employee Time Off POST /v1/scheduling/employee_timeoff Creates a time off request.
Request
Retrieve Employee Time GET /v1/scheduling/employee_timeoff/{timeOffRequestId} Returns a time off request.
Off Request by ID

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Employee Time POST /v1/scheduling/employee_timeoff/multi_read Returns time off requests matching
Off Requests specified search criteria.
Update Employee Time POST /v1/scheduling/employee_timeoff/apply_update Updates the state of a time off
Off Request request.

Employment Terms Paycode Edits

This resource specifies the characteristics of paycode edits applied to an employment term. The main characteristics of a paycode
edit are the paycode, the employee, the date, and the amount (either numeric or symbolic).
The characteristic of “paycode” (a Timekeeping entity related to paycode edits) is associated with accruals and payroll. Common
examples include the paycodes “Sick,” “Vacation,” “Training,” “Holiday,” and so on.
A paycode edit is an instance of a paycode associated with a specific employee at a specific time and thus part of the employee’s
schedule. For example, an employee might be assigned a Vacation paycode the first two weeks of July to replace two weeks of
regularly scheduled work, or a Sick paycode to replace half the scheduled work day of January 3. Once assigned, the entity is called
a paycode edit. Paycode edits can include the child objects Comments and Notes.

HTTP
Operation Method URL Endpoint Description
Create POST /v1/scheduling/employment_terms_schedule/pay_code_edits/apply_create Creates and returns the
Employment result of added
Terms PCEs Employment Terms
paycode edits to the
specified schedule
employment terms.
Delete POST /v1/scheduling/employment_terms_schedule/pay_code_edits/apply_delete Deletes multiple
Employment Employment Terms
Terms PCEs paycode edits.
Retrieve GET /v1/scheduling/employment_terms_schedule/pay_code_edits/{id} Returns the requested
Employment Employment Terms
Terms PCE by paycode edit.
ID
Update POST /v1/scheduling/employment_terms_schedule/pay_code_edits/apply_update Updates multiple paycode
Employment edits per employment
Terms PCEs term.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Group Assignments
This resource allows you to add or remove an employee’s membership in (or assignment to) various groups. Group assignments are
effective dated.

HTTP
Operation Method URL Endpoint Description
Add Group POST /v1/scheduling/group_schedule/assignments/apply_create Creates and returns group
Membership assignments according to the specified
parameters.
Remove Group POST /v1/scheduling/group_schedule/assignments/apply_delete Removes group assignments
Membership according to the provided criteria.

Group Paycode Edits

This resource specifies the characteristics of paycode edits applied to a group. The main characteristics of a paycode edit are the
paycode, the employee, the date, and the amount (either numeric or symbolic).
The characteristic of “paycode” (a Timekeeping entity related to paycode edits) is associated with accruals and payroll. Common
examples include the paycodes “Sick,” “Vacation,” “Training,” “Holiday,” and so on.
A paycode edit is an instance of a paycode associated with a specific employee at a specific time and thus part of the employee’s
schedule. For example, an employee might be assigned a Vacation paycode the first two weeks of July to replace two weeks of
regularly scheduled work, or a Sick paycode to replace half the scheduled work day of January 3. Once assigned, the entity is called
a paycode edit. Paycode edits can include the child objects Comments and Notes.

HTTP
Operation Method URL Endpoint Description
Create Group POST /v1/scheduling/schedule/groups/pay_code_edits/apply_create Creates and returns the result of
PCEs added group paycode edits to the
specified schedule groups.
Delete Group POST /v1/scheduling/schedule/groups/pay_code_edits/apply_delete Deletes multiple group paycode edits.
PCEs
Retrieve Group GET /v1/scheduling/schedule/groups/pay_code_edits/{id} Returns a group paycode edit.
PCE by ID
Update Group POST /v1/scheduling/schedule/groups/pay_code_edits/apply_update Updates multiple group paycode edits.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

PCEs

Group Schedule Patterns

This resource defines the repeating pattern of shifts and paycodes and assigns the pattern to an employee. Pattern assignments are
effective dated. Modifying the pattern assignment of an employee automatically affects the schedule of that employee.

HTTP
Operation Method URL Endpoint Description
Create Group Schedule POST /v1/scheduling/group_schedule_patterns/apply_create Creates a group schedule
Pattern pattern.
Delete Group Schedule DELETE /v1/scheduling/group_schedule_patterns/{id} Deletes a group schedule
Pattern by ID pattern.
Retrieve Group Schedule GET /v1/scheduling/group_schedule_patterns/builder Retrieves builder public settings
Pattern Configuration and configuration data.
Retrieve Group Schedule GET /v1/scheduling/group_schedule_patterns/{id} Retrieves a group schedule
Pattern by ID pattern.
Retrieve Multiple Group POST /v1/scheduling/group_schedule_patterns/multi_read Selects and retrieves group
Schedule Patterns schedule pattern entities.
Update or Remove Group POST /v1/scheduling/group_schedule_patterns/apply_update Updates or removes multiple
Schedule Patterns group schedule patterns.

Group Schedules—Manager Access

This resource provides the manager view of the schedule and allows modification of the schedule via the update operations.
This resource also provides update operations for entities applied to groups, group membership, and other characteristics of the
group. The group schedule for manager includes all the employee-related entities such as: shifts, paycode edits, holidays, locked
days, shift transfers, and detailed information about each entity.

HTTP
Operation Method URL Endpoint Description
Retrieve Employee GET /v1/scheduling/schedule/groups Returns a schedule according to the provided
Group Schedule information.
Retrieve Employee POST /v1/scheduling/schedule/groups/multi_read Returns a schedule according to the provided
information: employee, Hyperfind, location, or

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Group Schedule schedule group.
Update Schedule POST /v1/scheduling/schedule/groups/multi_update Updates group assignments and returns a
Group schedule according to the specified criteria.

Group Shifts
This resource allows you to create, modify, and delete shifts that are applied to a group.
Shifts are the primary content of the group schedule, since they represent productive work. The main shift characteristics are the
date, the start and end times, the assigned employee, and the job or jobs associated.
Shifts can be added, deleted, or modified. Shifts are made up of segments. There are three types of segment: regular, break, and
transfer. Each segment has a start time and date and an end time and date. Breaks have no associated job. A regular type segment
is always associated with the employee’s primary job as defined in People Editor. A transfer type segment is associated with the
transferred employee’s business structure job, work rule, payer cost center, or labor categories.

HTTP
Operation Method URL Endpoint Description
Create Group POST /v1/scheduling/schedule/groups/shifts/apply_create Creates and returns the result of creating
Shifts multiple shifts per group.
Delete Group POST /v1/scheduling/schedule/groups/shifts/apply_delete Deletes multiple group shifts.
Shifts
Retrieve Group GET /v1/scheduling/schedule/groups/shifts/{id} Returns a group shift.
Shift by ID
Update Group POST /v1/scheduling/schedule/groups/shifts/apply_update Updates multiple group shifts.
Shifts

Leave Edits—Scheduling
This resource allows you to create, read, update, and delete leave edits, which represent an instance of time that is charged against
a leave case and applied to an employee’s schedule. This instance has paid and tracking amounts to it.

HTTP
Operation Method URL Endpoint Description
Create Leave Edit POST /v1/scheduling/schedule/leave_edits Creates a leave edit.
Create Leave Edits with POST /v1/scheduling/schedule/leave_edits/apply_create Creates one or more leave edits

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Options with a set of options.
Delete Leave Edit by ID DELETE /v1/scheduling/schedule/leave_edits/{leId} Deletes a leave edit.
Delete Leave Edits POST /v1/scheduling/schedule/leave_edits/apply_delete Deletes one or more leave edits.
Retrieve Leave Edit by ID GET /v1/scheduling/schedule/leave_edits/{leId} Returns a leave edit.
Update Leave Edit by ID POST /v1/scheduling/schedule/leave_edits/{leId} Updates a leave edit.
Update Leave Edit with Bypass POST /v1/scheduling/schedule/leave_edits/apply_update Updates a leave edit with bypass
for Accrual Warnings for accrual warnings.

Manager Schedule Actions

This resource allows you to retrieve, post, or unpost a schedule.
Posting a schedule allows the schedule to be viewed by employees. The schedule sometimes needs to be unposted and this
resource also makes that possible. If so configured, specific employees can view unposted schedules.

HTTP
Operation Method URL Endpoint Description
Post or Unpost POST /v1/scheduling/schedule_management_actions/apply_update Posts or unposts scheduling
Schedule periods, shifts, or paycode edits.
Retrieve Posted POST /v1/scheduling/schedule_management_actions/multi_read Returns posted schedule records
Schedule with for the specified posting periods.
Criterion

Manager Schedules
This resource allows you to access the manager view of the schedule and allows modification of the schedule by means of update
operations.
The manager schedule includes all the employee-related entities, such as shifts, paycode edits, holidays, locked days, shift transfers,
schedule tags, and detailed information about each entity.

HTTP
Operation Method URL Endpoint Description
Retrieve Schedule POST /v1/scheduling/schedule/multi_read Returns a schedule matching specified search criteria.
Retrieve Schedule with GET /v1/scheduling/schedule Returns a schedule matching one search criterion.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Criterion
Update Schedule POST /v1/scheduling/schedule Performs a single update to a schedule.
Update Schedule— POST /v1/scheduling/schedule/multi_update Update the schedule for one or more employees
Multiple Employees pertaining to shifts, paycode edits, day locks, or
schedule tags.

Manager Time Off Requests

This resource allows a manager to approve, reject, or cancel time off requests submitted by an employee.
This resource also allows a manager to grant pre-approved time off to an employee. The time off has an impact on the schedule.
When a manager approves a request, the system automatically incorporates the change in the schedule. All or portions of an
employee’s shift are replaced with the appropriate paycode. Different time-off subtypes provide administrative control and all time off
requests are linked to paycodes. A manager granting preapproved time off does not require an open submission period. Depending
on configuration, the manager can grant time off for one day, a portion of a day, a symbolic portion of a day, multiple days, or multiple
portions or symbolic portions of days (whether in sequence or not). All time off requests are linked to paycodes. Different submittal
and approval criteria can be defined.

HTTP
Operation Method URL Endpoint Description
Create Manager Time Off POST /v1/scheduling/timeoff Creates a time off request.
Request
Retrieve Manager Time Off GET /v1/scheduling/timeoff/{timeOffRequestId} Returns a time off request.
Request by ID
Retrieve Manager Time Off POST /v1/scheduling/timeoff/multi_read Returns time off requests matching
Requests specified search criteria.
Update Manager Time Off POST /v1/scheduling/timeoff/apply_update Updates the state of a time off request.
Request
Update Manager Time Off PUT /v1/scheduling/timeoff/{timeOffRequestId} Updates a time off request.
Request by ID

Metrics—Scheduling

This resource allows you to evaluate metrics based on a set of metrics-related options and a set of search criteria.
Operation HTTP URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 Method
Evaluate Metrics for POST /v1/scheduling/schedule_metrics/multi_read Evaluates metrics based on the options specified
Scheduling and according to defined search criteria.

Paycode Edits—Scheduling
This resource allows you to specify the characteristics of paycode edits.
The main characteristics of a paycode edit are the paycode, the employee, the date, and the amount (either numeric or symbolic).
The characteristic of “paycode” (a Timekeeping entity related to paycode edits) is associated with accruals and payroll. Common
examples include the paycodes “Sick,” “Vacation,” “Training,” “Holiday,” and so on. A paycode edit is an instance of a paycode
associated with a specific employee at a specific time and thus part of the employee’s schedule. For example, an employee might be
assigned a Vacation paycode the first two weeks of July to replace two weeks of regularly scheduled work, or a Sick paycode to
replace half the scheduled work day of January 3. Once assigned, the entity is called a paycode edit. Paycode edits can include the
child objects Comments and Notes.

HTTP
Operation Method URL Endpoint Description
Create PCE POST /v1/scheduling/schedule/pay_code_edits Creates a paycode edit.
Create PCE with Options POST /v1/scheduling/schedule/pay_code_edits/apply_create Creates a paycode edit with a
set of options.
Create Paycode Edits POST /v1/scheduling/schedule/pay_code_edits/multi_create Creates one or more paycode
edits.
Delete PCE by ID DELETE /v1/scheduling/schedule/pay_code_edits/{pceId} Deletes a paycode edit.
Delete Paycode Edits by POST /v1/scheduling/schedule/pay_code_edits/multi_delete Deletes one or more paycode
ID edits.
Retrieve PCE by ID GET /v1/scheduling/schedule/pay_code_edits/{pceId} Returns a paycode edit.
Update PCE by ID POST /v1/scheduling/schedule/pay_code_edits/{pceId} Updates a paycode edit.
Update PCE with Bypass POST /v1/scheduling/schedule/pay_code_edits/apply_update Updates a paycode edit with
for Accrual Warnings bypass for accrual warnings.
Update Paycode Edits POST /v1/scheduling/schedule/pay_code_edits/multi_update Updates one or more paycode
edits.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Procedure Set Engine
This resource allows a manager to retrieve the sorted list by using a procedure set or the appropriate list of employees eligible for a
given open shift.

HTTP
Operation Method URL Endpoint Description
Retrieve Sorted or POST /v1/scheduling/staffing_assistant/apply_read Returns the list of sorted or eligible
Eligible Employees. employees depending on input parameters.

Procedure Sets
This resource provides a set of operations that allow you to retrieve procedure sets as a filtered list or singly by ID or name. A
procedure set is a sequence of instructions that completes a scheduling task, such as sorting employees, matching employees to
open shifts, and assigning employees with the best match.
• Procedure sets for the PSE can contain one step, or be complex and contain several steps.
• Procedure sets for the Call List and Sort Employees have one step.
Typically, a procedure set contains:
• Procedures — A procedure is a step that groups priority rule sets.
• Rule sets — A priority rule set groups related sorting and matching rules in order. A step can contain any number or type of rule
sets, in any order, or no rule sets at all.
HTTP
Operation Method URL Endpoint Description
Retrieve Procedure Set GET /v1/scheduling/procedure_sets/{id} Returns a single procedure set.
by ID
Retrieve Procedure Set GET /v1/scheduling/procedure_sets Returns a single procedure set by name.
by Name
Retrieve Procedure POST /v1/scheduling/procedure_sets/multi_read Returns a list of procedure sets filtered by object
Sets reference or procedure type.

Request Submission Periods

This resource allows you to define when an employee is allowed to submit a specific type of time-off request and the period during
which the time off may be taken.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

For example, in a certain department, the period when summer vacation may be taken runs from June 1 to August 31. Employees
are required to request their summer vacation time off no earlier than January 1 and no later than April 30.

HTTP
Operation Method URL Endpoint Description
Verify Request POST /v1/scheduling/request_submission_periods/apply_read Verifies the submission period or
Item Periods request period of a request item.

Rule Violations

This resource executes rules and returns any violations.

Operation HTTP Method URL Endpoint Description

Retrieve Employee Rule Violations POST /v1/scheduling/violations Returns rule violations along with explanations.

Schedule Audits
This resource allows you to generate an interactive display of all additions, deletions, and modifications to entities in the schedule.
This resource also returns events affecting the schedule as a whole, such as postings and unpostings.

Operation HTTP Method URL Endpoint Description

Retrieve Schedule Audits POST /v1/scheduling/audits/multi_read Returns schedule audits.

Schedule Builder Settings

This resource provides a set of operations that allow you to access and update schedule builder configurations.

HTTP
Operation Method URL Endpoint Description
Retrieve Schedule Builder GET /v1/scheduling/schedule_builder_settings Returns a list of Schedule Builder
Settings Settings.
Retrieve Schedule Builder GET /v1/scheduling/schedule_builder_settings/{id} Returns Schedule Builder Settings.
Settings by ID
Update Schedule Builder PUT /v1/scheduling/schedule_builder_settings/{id} Updates Schedule Builder Settings
Settings by ID by ID.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Schedule Patterns
This resource allows a manager to create, retrieve, update, and delete Schedule Patterns.
Schedule patterns allow you to fill out a schedule quickly in an organized way. Once you have defined and saved a pattern as a
Schedule template, you can assign it to any employee or group of employees.
Pattern Templates also make it possible to modify the schedule of a number of employees simultaneously by modifying the pattern
assigned to them.

HTTP
Operation Method URL Endpoint Description
Create Schedule POST /v1/scheduling/schedule_pattern_templates Creates a Schedule pattern.
Pattern
Create Schedule POST /v1/scheduling/schedule_pattern_templates/multi_create Creates a set of Schedule patterns.
Patterns
Delete Schedule DELETE /v1/scheduling/schedule_pattern_templates/{id} Deletes a Schedule pattern.
Pattern by ID
Delete Schedule DELETE /v1/scheduling/schedule_pattern_templates Deletes a Schedule pattern by name.
Pattern by Name
Delete Schedule POST /v1/scheduling/schedule_pattern_templates/multi_delete Deletes one or more Schedule patterns.
Patterns
Retrieve GET /v1/scheduling/schedule_pattern_templates/{id} Returns a Schedule pattern.
Schedule Pattern
by ID
Retrieve GET /v1/scheduling/schedule_pattern_templates Returns Schedule pattern.
Schedule Pattern
by Name
Retrieve POST /v1/scheduling/schedule_pattern_templates/multi_read Returns specific Schedule patterns by
Schedule object references or all Schedule
Patterns patterns if no references are provided.
Update Schedule PUT /v1/scheduling/schedule_pattern_templates/{id} Updates a Schedule pattern.
Pattern by ID
Update Schedule PUT /v1/scheduling/schedule_pattern_templates Updates a Schedule pattern by name.
Pattern by Name

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Update Schedule PUT /v1/scheduling/schedule_pattern_templates/multi_update Updates one or more Schedule patterns.
Patterns

Schedule Tags
This resource allows you to create, modify, and delete schedule tags.
Schedule tags are generic descriptors that can be used to add information to a schedule. They are user-defined and can either be
purely informational or they can have business-related impacts (like On Call tags). The main Schedule tag characteristics are the
date, the start and end times, the assigned employee, and the associated job or jobs. Schedule tags can be added, deleted, or
modified. A Schedule tag is similar to a Shift but with only one segment. It is always associated with the employee’s primary job,
defined in People Editor. A transfer type Schedule tag is associated with the transferred employee’s business structure job, work
rule, payer cost center or labor categories.

HTTP
Operation Method URL Endpoint Description
Create Schedule Tag POST /v1/scheduling/schedule/schedule_tags Creates a Schedule tag.
Create Schedule Tags POST /v1/scheduling/schedule/schedule_tags/multi_create Creates one or more Schedule
tags.
Delete Schedule Tag by ID DELETE /v1/scheduling/schedule/schedule_tags/{tagId} Deletes a Schedule tag.
Delete Schedule Tags POST /v1/scheduling/schedule/schedule_tags/multi_delete Deletes one or more Schedule
tags.
Retrieve Schedule Tag by GET /v1/scheduling/schedule/schedule_tags/{tagId} Returns a Schedule tag.
ID
Retrieve Schedule Tags POST /v1/scheduling/schedule/schedule_tags/multi_read Returns one or more Schedule
by ID tags.
Update Schedule Tag by POST /v1/scheduling/schedule/schedule_tags/{tagId} Updates a Schedule tag.
ID
Update Schedule Tags POST /v1/scheduling/schedule/schedule_tags/multi_update Updates one or more Schedule
tags.

Shift Templates
This resource allows a manager to create, retrieve, update, and delete shift templates.
A shift template is a shift that has a name and defined segments and attributes, but no date or assigned employee.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Use shift templates when any of the following apply:
• The organization uses standard shifts to assign to employees.
• Multiple employees work the same shift.
• Employees use Employee Self-Service (ESS) for scheduling to create and manage their own schedules.
HTTP
Operation Method URL Endpoint Description
Create Shift POST /v1/scheduling/shift_templates Creates a Shift Template.
Template
Create Shift POST /v1/scheduling/shift_templates/multi_create Creates a set of Shift Templates.
Templates
Delete Shift DELETE /v1/scheduling/shift_templates/{id} Deletes a Shift Template.
Template by ID
Delete Shift POST /v1/scheduling/shift_templates/multi_delete Deletes one or more Shift Templates.
Templates
Retrieve Shift GET /v1/scheduling/shift_templates/{id} Returns a Shift Template.
Template by ID
Retrieve Shift GET /v1/scheduling/shift_templates Returns a Shift Template.
Template by Name
Retrieve Shift POST /v1/scheduling/shift_templates/multi_read Returns specific Shift Templates by object
Templates references or all Shift Templates if no references
are given.
Retrieve or Create POST /v1/scheduling/shift_templates/apply_read Returns or creates a set of Shift Templates.
Shift Templates
Update Shift PUT /v1/scheduling/shift_templates/{id} Updates a Shift Template.
Template by ID
Update Shift PUT /v1/scheduling/shift_templates/multi_update Updates one or more Shift Templates.
Templates

Shifts
This resource allows you to create, modify, and delete shifts.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Shifts are the primary content of the schedule, since they represent productive work. The main shift characteristics are the date, the
start and end times, the assigned employee, and the job or jobs associated. Shifts can be added, deleted, or modified. Shifts are
made up of segments. There are three types of segment—regular, break, and transfer. Each segment has a start time and date, and
an end time and date. Breaks have no associated job. A regular type segment is always associated with the employee’s primary job,
defined in People Editor. A transfer type segment is associated with the transferred employee’s business structure job, work rule,
payer cost center or labor categories.

Operation HTTP Method URL Endpoint Description

Create Shift POST /v1/scheduling/schedule/shifts Creates a shift.
Create Shifts POST /v1/scheduling/schedule/shifts/apply_create Creates one or more shifts.
Create Shifts POST /v1/scheduling/schedule/shifts/multi_create Creates one or more shifts.
Delete Shift by ID DELETE /v1/scheduling/schedule/shifts/{shiftId} Deletes a shift.
Delete Shifts POST /v1/scheduling/schedule/shifts/multi_delete Deletes one or more shifts.
Retrieve Shift by ID GET /v1/scheduling/schedule/shifts/{shiftId} Returns a shift.
Update Shift by ID POST /v1/scheduling/schedule/shifts/{shiftId} Updates a shift.
Update Shifts POST /v1/scheduling/schedule/shifts/apply_update Updates shifts.
Update Shifts POST /v1/scheduling/schedule/shifts/multi_update Updates one or more shifts.

Tag Definitions
This resource allows a manager to create, retrieve, and update tag definitions.

HTTP
Operation Method URL Endpoint Description
Create Tag Definition POST /v1/scheduling/setup/tag_definitions Creates a tag definition.
Delete Tag Definition DELETE /v1/scheduling/setup/tag_definitions/{id} Deletes a tag definition.
by ID
Retrieve Tag GET /v1/scheduling/setup/tag_definitions/{id} Returns a tag definition.
Definition by ID
Retrieve Tag GET /v1/scheduling/setup/tag_definitions Returns a tag definition.
Definition by Name
Retrieve Tag POST /v1/scheduling/setup/tag_definitions/multi_read Returns tag definitions by references, by
Definitions with assignment context, or returns all tag

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Criterion definitions.
Update Tag Definition POST /v1/scheduling/setup/tag_definitions/{id} Updates a tag definition.
by ID

Team Definitions
This resource allows a manager to create, retrieve, and update team definitions.
Define teams to optimize guided recommendations for your organization so that managers can balance time-off requests with
coverage needs and accruals balances.

HTTP
Operation Method URL Endpoint Description
Create Team POST /v1/scheduling/setup/team_definition Creates a team definition.
Definition
Delete Team DELETE /v1/scheduling/setup/team_definition/{id} Deletes a team definition.
Definition by ID
Retrieve Team GET /v1/scheduling/setup/team_definition/{id} Returns a team definition.
Definition By ID
Retrieve Team GET /v1/scheduling/setup/team_definition Returns a team definition.
Definition by Name
Retrieve Team POST /v1/scheduling/setup/team_definition/multi_read Returns team definitions by team definition
Definitions with references or by employee references within
Criterion a date range.
Update Team PUT /v1/scheduling/setup/team_definition/{id} Updates a team definition.
Definition by ID

Time Off Request Guided Recommendations

This resource defines the retrieval of four different guided recommendations for time off requests, grouped by team, guided
recommendations, absence requests, and accruals.

HTTP
Operation Method URL Endpoint Description
Retrieve Guided POST /v1/scheduling/time_off_request_guided_recommendations/apply_read Returns guided
recommendations

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Recommendations records based on the
specified criteria.

Workload Coverage
This resource allows for the evaluation of workload coverage.

HTTP
Operation Method URL Endpoint Description
Evaluate Coverage POST /v1/scheduling/workload_coverage/coverage/multi_read Returns coverage results.
Evaluate Coverage POST /v1/scheduling/workload_coverage/coverage_detail/multi_read Returns coverage detail
Details results.
Evaluate Coverage POST /v1/scheduling/workload_coverage/coverage_span/multi_read Returns coverage span
Spans results.
Evaluate Workload POST /v1/scheduling/workload_coverage/workload/multi_read Returns workload results.
Evaluate Workload POST /v1/scheduling/workload_coverage/workload_detail/multi_read Returns workload detail
Details results.

Timekeeping
Timekeeping automates the collection, management, and distribution of employee hours. It allows organizations to configure
business rules for managing employee time, such as pay rules that determine what is overtime, who is eligible for overtime, who is
working what job, and what is the schedule. This domain also allows organizations to schedule employees and manage accruals and
vacation time. Time and labor data are collected from Series 4500 and InTouch terminals and delivered through Universal Device
Manager to the suite, from which it can be used directly by Accruals, Activities, Dataviews, and reports, Insight Metrics, Scheduling,
and other components.
• Accrual Codes
• Accrual Move Balances
• Accrual Profiles
• Accruals
• Accruals Bulk Import
• Accruals Bulk Update
• Adjustment Rules
• Bonus and Deduction Rules

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

• Break Rules
• Comments
• Employment Terms
• Pay Codes—Timekeeping
• Percentage Allocation Rules
• Punches
• Signoffs for Employee
• Signoffs for Manager
• Timecard Approvals for Employee
• Timecard Approvals for Manager
• Timecard Metrics
• Timecard Settings
• Timecards
• Timestamps
• Work Rules

Accrual Codes
This resource allows you access to accrual codes, which collect and hold the different accrual balances, such as the total number of
hours, days, or money. These codes identify the types of accrual balances, such as vacation or sick.

Operation HTTP Method URL Endpoint Description

Retrieve Accrual Code by ID GET /v1/timekeeping/setup/accrual_codes/{id} Returns an accrual code.
Retrieve Accrual Codes GET /v1/timekeeping/setup/accrual_codes Returns a list of accrual code types.

Accrual Move Balances

This resource allows you to move one or more accrual balances for multiple employees. The associated Function Access Control
Point is API.Accrual.
Accruals normally represent entitlements, such as Vacation, Sick Leave, Bereavement and others, that are calculated by the system
based on data entries from the Timecard, the API, or other entry points. Each accrual balance is associated with an accrual code,
which is similar to a pay code. Each employee can have a unique set of accrual balances which are managed through an Accrual
Profile.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Move Accrual Balances—Multiple POST /v1/timekeeping/accruals/moves Applies a move action on one or more
Employees accrual balances.

Accrual Profiles
This resource allows you access to accrual profiles, which enable you to group different accrual policies and assign them to one or
more employees. For example, you have full-time staff members who accrue vacation time, sick time, and bonus money at different
rates. Create Full-time Vacation, Full-time Sick, and Full-time Bonus rules and group these policies in a profile named Full-time Staff
Members.

Operation HTTP Method URL Endpoint Description

Retrieve Accrual Profile by ID GET /v1/timekeeping/setup/accrual_profiles/{id} Returns an accrual profile type.
Retrieve Accrual Profiles GET /v1/timekeeping/setup/accrual_profiles Returns a list of accrual profile types.

Accruals
The Accruals resource allows you to manage one or more accrual balances or transactions within the system for one to many
employees, including various accrual actions such as resets and updates. The operations on this resource support identifying child
objects for ShiftTotals by Pay Code, Accrual Summaries, and bulk operations. The associated Function Access Control Point is
API.Accrual.
Accruals normally represent entitlements, such as Vacation, Sick Leave, Bereavement and others, that are calculated by the system
based on data entries from the Timecard, the API, or other entry points. Accruals operations are either transactions or balance
inquiries/adjustments. Each accrual balance is associated with an accrual code, which is similar to a pay code. Each employee can
have a unique set of accrual balances which are managed through an Accrual Profile.

HTTP
Operation Method URL Endpoint Description
Retrieve Accrual Codes POST /v1/timekeeping/paycodes_to_accrual_codes/multi_read Returns a list of matching accrual
from Pay Codes codes from a list of pay codes.

Accruals Bulk Import

Allows you to perform bulk imports of accruals.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Perform Bulk Accrual Payouts POST /v1/timekeeping/accruals/payouts Performs a bulk accrual payouts
action.
Perform Bulk Accrual Resets POST /v1/timekeeping/accruals/resets Performs a bulk accrual reset action.
Perform Bulk Accrual POST /v1/timekeeping/accruals/suspensions Performs a bulk accrual
Suspension/Reinstate suspension/reinstate.

Accruals Bulk Update

Allows you to perform bulk updates of accruals.

HTTP
Operation Method URL Endpoint Description
Apply Updates to Accrual Balances—Multiple POST /v1/timekeeping/accruals/updates Bulk updates accrual
Employees balances.

Adjustment Rules
This resource provides a set of operations that allow you to create, read, update, and delete Adjustment Rules.
Use Adjustment Rules to change wages or to pay extra, based on time entered in a timecard. Adjustments can be made based on
multiple labor accounts and selection criteria, such as a job, a pay code, or both. Adjustments can also be effective dated.

HTTP
Operation Method URL Endpoint Description
Add an Adjustment Rule POST /v1/timekeeping/setup/adjustment_rules/{id} Adds an Adjustment Rule Version to the
Version specified Rule.
Create Adjustment Rule POST /v1/timekeeping/setup/adjustment_rules Creates an Adjustment Rule.
Delete Adjustment Rule by DELETE /v1/timekeeping/setup/adjustment_rules/{id} Deletes an Adjustment Rule by ID.
ID
Retrieve Adjustment Rules GET /v1/timekeeping/setup/adjustment_rules Returns a list of Adjustment Rules.
Update Adjustment Rule PUT /v1/timekeeping/setup/adjustment_rules/{id} Updates an Adjustment Rule by ID.
by ID

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Bonus and Deduction Rules
This resource allows you access to bonus and deduction rules. Bonuses and deductions are amounts that are automatically added to
or deducted from timecards.

HTTP
Operation Method URL Endpoint Description
Retrieve Bonus and Deduction GET /v1/timekeeping/setup/deduct_rules Returns a list of bonus and deduction
Rules rules.
Retrieve Bonus or Deduction Rule GET /v1/timekeeping/setup/deduct_rules/{id} Returns a bonus or deduction rule.
by ID

Break Rules
This resource allows you access to break rules, which apply to any type of break or meal. The rules specify when a punch is a break
and how punches round. The break definition has Break Lengths, Break Settings, and Rounds and Graces sections.

Operation HTTP Method URL Endpoint Description

Retrieve Break Rule by ID GET /v1/timekeeping/setup/break_rules/{id} Returns a break rule.
Retrieve Break Rules GET /v1/timekeeping/setup/break_rules Returns a list of break rules.

Comments

The API support GET operation to retrive the comments information.

Operation HTTP Method URL Endpoint Description

Retrieve Comments GET /v1/commons/comments findComments

Employment Terms
This resource provides create, read, update, and delete operations for managing an employment term.
Employment terms are legal contracts between employees and employers that establish the conditions of employment before the
employee begins work.

HTTP
Operation Method URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Create Employment Term POST /v1/timekeeping/setup/employment_terms Creates an employment term.
Delete Employment Term by ID DELETE /v1/timekeeping/setup/employment_terms/{id} Deletes an employment term by
ID.
Retrieve Employment Term GET /v1/timekeeping/setup/employment_terms Returns an employment term.
Retrieve an Employment Term GET /v1/timekeeping/setup/employment_terms/{id} Returns an employment term.
Update Employment Term by PUT /v1/timekeeping/setup/employment_terms/{id} Updates an employment term by
ID ID.

Pay Codes—Timekeeping
This resource allows you access to pay codes, which enable you to organize time or money that employees earn and identify spans
of time for payroll purposes.

HTTP
Operation Method URL Endpoint Description
Retrieve Pay Code GET /v1/timekeeping/setup/employee_pay_code_symbolic_values Returns a list of all
Symbolic Values— Timekeeping Pay code
Employee symbolic values available to an
employee.
Retrieve Pay Code GET /v1/timekeeping/setup/employee_pay_code_symbolic_values/{id} Returns a list of all
Symbolic Values— Timekeeping Pay code
Employee symbolic values available to an
employee.
Retrieve Pay Code GET /v1/timekeeping/setup/pay_code_symbolic_values Returns a list of all
Symbolic Values— Timekeeping Pay code
Manager symbolic values available to a
manager.
Retrieve Pay Code GET /v1/timekeeping/setup/pay_code_symbolic_values/{id} Return a Timekeeping pay
Symbolic Value— code symbolic value available
Manager to a manager.
Retrieve Pay Code GET /v1/timekeeping/setup/employee_pay_codes/{id} Return a Timekeeping pay
by ID—Employee code available to an employee.
Retrieve Pay Code GET /v1/timekeeping/setup/pay_codes/{id} Return a Timekeeping pay
by ID—Manager code available to a manager.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Retrieve Pay GET /v1/timekeeping/setup/employee_pay_codes Returns a list of all
Codes—Employee Timekeeping pay codes
available to an employee.
Retrieve Pay GET /v1/timekeeping/setup/pay_codes Returns a list of all
Codes—Manager Timekeeping pay codes
available to a manager.

Percentage Allocation Rules

This resource provides create, read, update, and delete operations for managing fixed percent allocation rules.
Use percentage allocation rules to allocate employee time across multiple labor accounts based on a selection criterion (labor
account, job, or pay code). The rules are based on a pre-defined percentage distribution.
For example, an employee’s daily time is allocated evenly between two labor accounts. The employee works eight hours. The
system allocates four hours for each labor account on that day. On the following day, the employee works ten hours. If overtime is
also allocated in the rule, the system allocates five hours in each labor account. If overtime is not included in the rule, the system
allocates four hours for each labor account and two hours for overtime.

HTTP
Operation Method URL Endpoint Description
Add an FPARuleVersion into POST /v1/timekeeping/setup/percentage_allocation_rules/{id} Add an FPARuleVersion.
specified Rule
Create Percentage POST /v1/timekeeping/setup/percentage_allocation_rules Creates a fixed percentage
Allocation Rule allocation rule.
Delete Percentage DELETE /v1/timekeeping/setup/percentage_allocation_rules/{id} Deletes a fixed percentage
Allocation Rule by ID allocation rule by ID.
Retrieve Percentage GET /v1/timekeeping/setup/percentage_allocation_rules Returns a list of fixed
Allocation Rules percentage allocation rules.
Update Percentage PUT /v1/timekeeping/setup/percentage_allocation_rules/{id} Updates a fixed percentage
Allocation Rule by ID allocation rule by ID.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Punches
The Punches resource allows you to add, delete, or change a punch object within the system. It also supports identifying child
objects for Comments, Notes, Exceptions, and OrgJob. This resource supports rule transfers from an existing punch before and after
the sign-off date. The associated Function Access Control Point is API.Timecard.
Punches are the entries on a timecard that mark the beginning (in-punch) or end (out-punch) of a work interval, such as the
beginning of a shift or transfer. A punch registers, using a data collection device, employees’ attendance at work, and their hours
worked. Employees “punch” when starting or ending a shift, meal, or break. Employees can punch in a variety of ways, depending on
the data collection device.

Operation HTTP Method URL Endpoint Description

Import Punches—Multiple Employees POST /v1/timekeeping/punches/import Imports one or more punches.

Signoffs for Employee

The Signoffs resource allows you to retrieve employee timecard sign-off information, sign off an employee timecard, or remove an
employee timecard sign-off. Timecard sign-off prevents further timecard and schedule edits and grants final approval to timecards
before they are processed by payroll.

HTTP
Operation Method URL Endpoint Description
Delete Employee Timecard DELETE /v1/timekeeping/employee_timecard_signoffs Deletes (removes) an employee
Signoff-Employee timecard sign-off.
Retrieve Signoffs-Employee GET /v1/timekeeping/employee_timecard_signoffs Returns employee timecard sign-off
information.
Sign off Employee Timecard- POST /v1/timekeeping/employee_timecard_signoffs Signs off an employee timecard for a
Employee specified timeframe.

Signoffs for Manager

The Signoffs resource allows you to retrieve employee timecard sign-off information, sign off an employee timecard, or remove an
employee timecard sign-off. Timecard sign-off prevents further timecard and schedule edits and grants final approval to timecards
before they are processed by payroll.

HTTP
Operation Method URL Endpoint Description

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Delete Employee Timecard DELETE /v1/timekeeping/timecard_signoffs Deletes (removes) an employee timecard
Signoff-Manager sign-off.
Retrieve Signoffs-Manager GET /v1/timekeeping/timecard_signoffs Returns employee timecard sign-off
information.
Sign off Employee Timecard- POST /v1/timekeeping/timecard_signoffs Signs off an employee timecard for a
Manager specified timeframe.

Timecard Approvals for Employee

The Timecard Approvals for Employee resource allows the logged-in employee to add, retrieve, and delete (remove) approval of his
or her own timecard.

HTTP
Operation Method URL Endpoint Description
Approve Timecard- POST /v1/timekeeping/employee_timecard_approvals Adds a timecard approval.
Employee
Remove Timecard DELETE /v1/timekeeping/employee_timecard_approvals Deletes/removes employee timecard approval
Approvals-Employee for the logged-in employee and given date
range.
Retrieve Timecard GET /v1/timekeeping/employee_timecard_approvals Returns a list of timecard approvals for the
Approvals-Employee logged-in employee and given date range.

Timecard Approvals for Manager

The Timecard Approvals for Manager resource allows a manager to add, retrieve, and delete (remove) manager approval of
employee timecards.
Typically, after employees approve their timecards, a manager also reviews and approves them. Depending on the manager’s
access, the manager may also be able remove her approval to edit employee timecards or even edit them without removing her
approval.
When employee timecards are ready for payroll processing, the manager signs off their timecards. Depending on the manager’s
access, she may also be able to remove her signoff to make additional changes. She cannot remove the approval after the timecard
is signed off unless she removes her signoff first.
Before a manager approves or signs off a timecard, she should resolve any exceptions.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

 HTTP
Operation Method URL Endpoint Description
Approve Timecard- POST /v1/timekeeping/timecard_approvals Adds a timecard approval.
Manager
Remove Timecard DELETE /v1/timekeeping/timecard_approvals Deletes/removes manager timecard approval for the
Approvals-Manager given employee and date range.
Retrieve Timecard GET /v1/timekeeping/timecard_approvals Returns a list of timecard approvals for the given
Approvals-Manager employee and date range.

Timecard Metrics
This resource allows you to access a range of metrics related to employee timecards, such as averages, exception counts, data
related to full time and part time employees, projected, scheduled, actual, and corrected totals, accrual transactions and summaries,
and total summaries broken down by projected, scheduled, and actual for shift totals and daily totals.

HTTP
Operation Method URL Endpoint Description
Retrieve Timecard Data— POST /v1/timekeeping/timecard_metrics/multi_read Returns timecard data matching the
Multiple Employees specified search criteria.

Timecard Settings
This resource allows you access to timecard settings. Operations against this resource allow you to create, read, update, and delete
timecard settings data.
A timecard setting allows you to define what each employee sees in his or her timecard user interface. Such settings include the
types of actions each employee can perform and which addons are displayed.
These settings apply only to the suite’s main user interface and do not allow control over any aspect of third-party user interfaces
built on the API.

HTTP
Operation Method URL Endpoint Description
Create Timecard Setting POST /v1/timekeeping/setup/timecard_settings Creates a Timecard setting.
Delete Timecard Setting by ID DELETE /v1/timekeeping/setup/timecard_settings/{id} Deletes a Timecard setting.
Retrieve Timecard Setting by GET /v1/timekeeping/setup/timecard_settings/{id} Returns a Timecard setting.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

ID
Retrieve Timecard Settings GET /v1/timekeeping/setup/timecard_settings Returns a list of all Timecard
settings.
Update Timecard Setting by ID PUT /v1/timekeeping/setup/timecard_settings/{id} Updates a Timecard setting.

Timecards
This powerful resource allows you to retrieve and update employee timecards as either an employee or a manager.
You can retrieve an employee’s timecard as an employee or manager, or retrieve a list of timecards for multiple employees by
providing employee identifiers or Hyperfind query details.
You can update virtually any aspect of an employee timecard, including totals, exceptions, punches, comments on punches and pay
code edits, transfers, cost centers, pay rules, and annotations. Timecard updates support Pay from Schedule functionality. Please
see the request model for each update operation for more information about incorporating timecards into your application.
Qualifiers
The following qualifiers apply to operations against the Timecard resource:
• The Hyperfind qualifier is the Hyperfind name.
• The Symbolic Period qualifier is the pay period name.
• The Employee qualifier is the person number.
HTTP
Operation Method URL Endpoint Description
Retrieve Timecards- POST /v1/timekeeping/employee_timecard/multi_read Returns a list of timecards matching
Employee specified search criteria.
Retrieve Timecards- POST /v1/timekeeping/timecard/multi_read Returns a list of timecards matching
Manager specified search criteria.
Retrieve Timecard— GET /v1/timekeeping/employee_timecard Returns an employee timecard by
Employee employee and timeframe.
Retrieve Timecard— GET /v1/timekeeping/timecard Returns a manager timecard by employee
Manager and timeframe.
Update Timecard— POST /v1/timekeeping/employee_timecard Updates a timecard for an employee as an
Employee employee.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.

Update Timecard— POST /v1/timekeeping/timecard Updates a timecard for an employee as a
Manager manager.

Timestamps
The Timestamps resource allows you to record in and out punches with a timestamp. Depending on your access rights, you may also
be able to make job or work rule transfers and cancel meal or break deductions.

HTTP
Operation Method URL Endpoint Description
Add Timestamp POST /v1/timekeeping/timestamps Adds a timestamp for a punch.
Retrieve MRU GET /v1/timekeeping/most_recently_used_transfers Returns a list of the most recently used (MRU)
Transfers transfers for the current user.
Retrieve GET /v1/timekeeping/timestamps Returns the last recorded timestamp.
Timestamp

Work Rules
This resource allows you access to work rules, which are combinations of work rule building blocks that apply specific pay rules to
shifts. These rules determine how employee hours accrue. A default work rule is usually part of a pay rule, but work rules can also be
assigned in the timecard and Scheduler.

HTTP
Operation Method URL Endpoint Description
Retrieve Work Rule by GET /v1/timekeeping/setup/employee_work_rules/{id} Retrieves one work rule for an employee.
ID—Employee
Retrieve Work Rule by GET /v1/timekeeping/setup/work_rules/{id} Returns a Timekeeping work rule
ID—Manager available to a manager.
Retrieve Work Rules— GET /v1/timekeeping/setup/employee_work_rules Retrieves an employee’s work rules.
Employee
Retrieve Work Rules— GET /v1/timekeeping/setup/work_rules Returns a list of all Timekeeping work
Manager rules available to a manager.

1-1.5.0 04-18-2018

© 2018, Kronos Incorporated.