We are excited to introduce v2025-04-01 (Taylor) of our API! This version brings a wide range of enhancements, making our API more powerful and adaptable without breaking changes.
Just like the Taylor series approximates complex functions by breaking them down into simpler polynomial terms, this API update refines and extends existing functionalities, making your integrations more precise and efficient with incremental but impactful changes.
The most significant enhancements focus on Contracts, Finance, and Employee endpoints and webhooks, while other key areas, including ATS, Attendance, Banking, Performance, and Project Management, also benefit from new endpoints and expanded field options.
Check out the full Changelog for a deeper dive into all the new features and enhancements.
Let us know how you leverage these updates to improve your processes!
Estimated time is used in attendance to know how many time is planned for employee/date to work. From this resource we get the original planned time, how this time has been affected by bank holidays and leaves and the planned shifts and breaks in case there are.
All Responses
New Field id has been added Id to specify the estimation time it includes the employee_id and date
Banking > Bank account
Bank Account represent a bank account that can be used to perform transactions, review balances and more.
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
All Responses
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
Contracts > Reference contract
All Responses
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field seniority_calculation_date has been added Date since when the employee is working in the company.
New Field contracts_bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field contracts_working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field contracts_max_legal_yearly_hours has been added The maximum amount of hours the employee can work in a year.
New Field contracts_maximum_weekly_hours has been added The maximum amount of hours the employee can work in a week.
All Responses
New Field termination_type_description has been added The description of the termination type.
New Field termination_reason_type has been added Termination reason type of the employee
New Field seniority_calculation_date has been added Date since when the employee is working in the company.
Expenses > Expensable
Represents an expensable resource, which can be a regular expense or a mileage expense.
All Responses
New Field internal_reference has been added The optional internal reference of the expensable
Finance > Account
Ledger account refers to a structured entity that represents an account within a general ledger system.
Ledger account resource refers to a structured entity that represents an account within a general ledger system. It serves as a digital record for tracking financial transactions related to a specific category. (e.g. bank account, vendor, tax type, expense, etc.)
New Field employee_potential_score_enabled has been added Include one question at the end of the review to rate participants' potential. this rating will be reflected in the 9 box grid.
Performance > Review questionnaire by strategy
Performance Review Questionnaire by reviewer strategies
All Responses
New Field employee_potential_score_manager_questionnaire has been added Questionnaire included in the end of manager evaluation to evaluate the employee potential
ProjectManagement > Exportable project
Project Management Exportable Projects
All Responses
New Field client_id has been added The client id of the project
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
We are happy to announce the new v2025-01-01 (Fourier) version has been released. Most of the API remains the same, with updated endpoint paths.
As you know, our versions are named after famous numeric series. The Fourier series is renowned for breaking down complex patterns into simple, steady components. Similarly, this release reflects our commitment to clarity and dependability, ensuring our endpoints work seamlessly and reliably.
The most relevant parts are Performance endpoints and webhooks. Other additions are contract type endpoints and improvements in Ats, Attendance, Employees, Expenses, Teams, and Project Management resources.
Don't miss out on the news it brings and read the detailed Changelog
New Field competencies_assessments_enabled has been added Whether the competencies assessments are enabled or not. this will allow assessing competencies for self and manager evaluations
All Responses
New Field competencies_assessments_configuration has been added Configuration of the competencies assessments feature
Represents a specific time frame where a schedule applies. It has a day and month for for beginning and end, but not a year: it is assumed it repeats every year at the same dates.
As you know, our versions are named as famous numeric series. In mathematics, the Fibonacci sequence is a sequence in which each number is the sum of the two preceding ones.
The Fibonacci series has rapid growth, just like this version, which includes, among other things, the following changes:
The most relevant parts are Performance endpoints and webhooks, which are new in this version. Other additions are workplace information in EmployeeUpdates, Shift name information in ShiftManagement, as well as other improvements in Attendance, Expenses, Training, Tasks, and Project Management resources.
Don't miss out on the news it brings and read the detailed Changelog
In these last quarter, we have driven the Factorial's public API to first class. We have set the foundations for a fully stable and versioned public API. This means we have set the following changes:
Stabilizing version v2
V2 version has been in the oven for several months. Last July, we started to publish in v2 everything missing from v1. All the functionality in v1 must be now available in v2. If this is not the case, please contact us and let us know
We finally released v2 version at the beginning of September, deprecating v1 version
Versioned v2: 2024-10-01 and next
But we didn't stop here. Factorial's product teams move fast. They are constantly improving to deliver value to our clients. And the public API improves with them. Many of the new features are exposed to the public API, so our clients and developer partners can use them and bring more value to our users.
On the other hand, we know that public API consumers have their own pace. Keeping up to date with Factorial's API changes is probably not the first thing on their ToDO list.
This is why we are introducing API versioning in our v2 public API version. Every quarter, we are evolving our v2 version to new releases, without losing backwards compatibility within a year. This way, we give our API consumers enough time to adapt to new changes, while our product teams evolve fast.
Upgrading to newer versions should be must easy, just changing the paths most of the time. We will be publishing a detailed changelog, like 2024-10-01 Release Notes so clients and partners are able to easily upgrade.
Deprecating v1
Our v1 version has served us well for years, but it has several flaws and we need to move on. V1 version will keep working until April 1st, 2025. Afterward, it will be removed. Working webhooks will be automatically migrated to v2.
New Field disability_percentage_cents has been added - officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents
Response
New Field disability_percentage_cents has been added - officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents
EmployeeUpdates > New hire
Response
New Field workplace_id has been added - workplace id of the employee.
EmployeeUpdates > Personal change
Response
New Field workplace_id has been added - workplace id of the employee.
New Field objectives has been added - Objectives of the course
Response
New Field objectives has been added - Objectives of the course
New Field number_of_expired_participants has been added - Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.
Trainings > Training membership
Response
Modified Field training_completion_date has been renamed to training_completed_at - This field is used to record the date a training was completed for trainings that have an expiry date.
New Field disability_percentage_cents has been added - officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents
New Field disability_percentage_cents has been added - officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents
New Field disability_percentage_cents has been added - officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents
New Field disability_percentage_cents has been added - officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents
New Field disability_percentage_cents has been added - officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents
New Field objectives has been added - Objectives of the course
New Field number_of_expired_participants has been added - Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.
New Field objectives has been added - Objectives of the course
New Field number_of_expired_participants has been added - Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.
New Field objectives has been added - Objectives of the course
New Field number_of_expired_participants has been added - Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.
New Field objectives has been added - Objectives of the course
New Field number_of_expired_participants has been added - Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.
New Field objectives has been added - Objectives of the course
New Field number_of_expired_participants has been added - Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.
New Field objectives has been added - Objectives of the course
New Field number_of_expired_participants has been added - Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.
Welcome to the developer hub and documentation for factorial! We just launched the first version of our public API.
The Factorial API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.
Make sure to regularly check the changelog, as we will be continuously improving the Factorial API, always keeping in mind retro compatibility through versioning.
