Kolay İK

List people in the company, with filtering and page-number pagination. Polling source for new hires.

Get the full record of one person by id.

Get a compact summary (name, contact, current unit) of one person.

Fetch several people at once by passing a list of ids.

Add a new employee. Only firstName and lastName are required; all other fields are optional. The body carries a top-level 'person' object (with optional dataList[] of {fieldToken,value} and unitList[]).

Update an existing person's fields. The body carries a top-level 'person' object.

Mark a person as having left the company (offboarding). Irreversible HR action.

Re-activate a previously terminated person.

Get the leave balances / entitlement statuses for one person.

List the custom data fields configured for the company, with their fieldToken and type. Call before sending person.dataList on create/update.

Attach a file to a person's record.

List the files attached to a person.

Remove one file attached to a person's record.

Remove a file folder from a person's record.

Assign a training course to a person.

Update a person's assigned training (status, dates).

List the trainings assigned to one person.

Remove a training assignment from a person.

List calendar events, filterable by search and date range, with paging.

Get one calendar event.

Create a calendar event.

Update a calendar event.

Delete a calendar event.

List training courses, with search and paging.

Get one training course.

Create a training course in the company catalog.

Update a training course.

Delete a training course.

List time entries, filterable by person, type (work/overtime), status and date range; supports paging and sorting.

Get one time entry.

Create a time entry (work or overtime) for a person. NOTE: Kolay İK accepts these inputs as query-string parameters on the POST request (not a JSON body).

Remove a time entry.

List transactions (advances/expenses), filterable by person, type, status, paid flag and date range.

Get one transaction.

Create a transaction record (advance/expense) for a person.

Remove a transaction.

List leave records, filterable by status, date window and person. Returns a flat data[] array. Polling source for new leave records.

Get one leave record in full.

Create a leave entry for a person. NOTE: Kolay İK accepts these inputs as query-string parameters on the POST request (not a JSON body).

Get the full organization tree (companies, branches, departments and their items).

Add an item to an org unit (e.g. a new location named 'Amsterdam').

List the configured approval processes and their steps/approvers.

List expense categories, filterable by title and enabled flag.

List payroll runs (bordro dönemleri). Pass year to filter (max = current year + 1, defaults to current year).

Fetch one payroll sheet by its id (use Get Payroll List first to obtain the id).

Get basic info about the authenticated token's identity. Safe, read-only connectivity/health check.