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 as famous numeric series. In mathematics, The Fourier series efficiently captures the oscillatory nature of functions, much like our endpoints, which have evolved to include, among other things, the following changes:
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.
