We built the Skill Engine API around a domain-driven philosophy: our goal is to
express functionality in the same language that our customers and end-users
speak. That way, the Skill Engine API maps onto your use case with the least
amount of friction. This page describes the available entity types and their
meaning and functionality.
Throughout this developer portal, entity names are capitalized. For example,
‘Employee’ indicates an Employee entity.
The Skill Engine API supports four entity types:
Employee: represents either a person within your organization or a
candidate within the job market.
Vacancy: corresponds to job postings or open positions.
Course: any internal or external training or education.
Occupation: a generic role or function defined by your organization.
All of these entities share the following properties:
An entity in the Skill Engine API corresponds to the same one in your
organization and is mapped one-on-one with them. For example, each Employee
entity links to one (and only one) employee in your core systems.
An entity has a single and meaningful skill profile.
An entity’s lifecycle is explicitly managed: you are in control of its
continued existence.
An entity can have custom properties that are used for filtering,
enhanced matching, and advanced querying.
We know that your use case may require unique business logic. We accommodated
the Skill Engine to integrate your logic on demand. It has customization
built-in, rather than worrying about it after the fact.Do you want to use properties like work regimes, country preferences, or
ratings? Custom properties will be your go-to tool. Head over to
the custom properties tutorial to get
started with your desired custom properties. We also provide our customers with
integration support, so if you want to learn even more about mapping your use
case, don’t hesitate to get in touch!