We provide a host of standard exports in our API to return useful information in bulk. These API exports have the following properties:

  • The data contained in the API export is a reflection of the data at the time of the request (i.e., live data).
  • The output will always be given in the default JSON format of the API.
  • Most exports use pagination, returning the data piece by piece instead of in bulk.
  • Especially when working with large amounts of data, the export API requests can often take some time to complete.

As an alternative to these API exports, we provide a similar host of file-based exports. These standard file-based output exports are triggered according to a configurable schedule (e.g. daily), transform the data to a desired format (e.g. CSV) and are uploaded to a desired, easily accessible location (e.g. S3). As such, these export integrations have the following advantages:

  • No time-consuming live generation required: the last export is always readily available on the desired location (i.e. S3, SFTP server).
  • No need to handle data tranformation.
  • No need to handle pagination.

We prefer CSV files in a specific format. See our formatting reference for more info.

Prerequisites

To have access to the file-based output integrations, regardless of type, at least the following prerequisites must be met:

  • You have the appropriate TechWolf API licenses.
  • You have the appropriate SkillEngine API credentials, which include:
    • Tenant ID
    • Tenant secret
    • Tenant name
    • Region (Europe or United States)
  • You have a TechWolf API tenant set up that contains the relevant information for the requested output integration.
  • Both you and TechWolf have access to the agreed output location.

Supported export types

Employee Info

Provides an overview of all Employees and their fields, including their current position, organizational unit, and data availability status.

Entity Relationships:

Job Info

Provides an overview of all Jobs and their fields, including Job Family information, data availability status, and active status.

Entity Relationships:

Course info

Provides an overview of all available Courses, including their titles and source systems.

Entity Relationships:

Course Skill Profiles (Course to Skill)

Maps the relationship between Courses and their associated Skills, showing which Skills are taught in each Course.

Entity Relationships:

Employee Skill Profiles (Employee to Skill)

Maps the relationship between Employees and their Skills, including validation states and sources of skill inference.

Entity Relationships:

Job Skill Profiles (Job to Skill)

Maps the relationship between Jobs and their required Skills, including skill types, validation states, and proficiency levels.

Entity Relationships:

Skill Info

Provides comprehensive information about all Skills, including descriptions and their location in the Taxonomy.

Entity Relationships:

Employee Skill Gap

Shows the match score between Employees and their assigned positions, helping identify Skill gaps.

Entity Relationships:

Employee Skill Gap Explained

Provides detailed analysis of Skill gaps between Employees and their positions, including adjacent Skills and alignment scores.

Entity Relationships:

Internal Mobility

Shows potential matches between Employees and Jobs within the organization, with match scores.

Entity Relationships:

Internal Mobility Explained

Provides detailed analysis of potential matches between Employees and Jobs, including Skill-level comparisons.

Entity Relationships:

Market Info

Shows the configuration of peer groups and their member companies.

Entity Relationships:

Market Skill Profiles (Market to Skill)

Shows the Skills required by companies in different peer groups for each Job.

Entity Relationships:

Market Comparison

Shows alignment scores between Jobs and their peer group market Skill Profiles, in both directions.

Entity Relationships:

Market Comparison Explained

Provides detailed analysis of alignment between Jobs and peer group Skill Profiles, including Skill-level comparisons.

Entity Relationships:

Supported output locations

S3

We support the use of Amazon S3 buckets as the location the above-mentioned output integrations can be shared. These buckets are owned and managed by TechWolf, but will be made accessible to you to fetch the export files.

Export output files will be located on your bucket, named techwolf-X (with ‘X’ being your company name or abbreviation), under the output/exports directory.

The names of the files can be configured per file type, but the names must always contain the date at which they were created in one of the supported date formats. For compatibility reasons, names cannot contain semicolons (’:’) or periods (’.’).

Coming soon

  • Private SFTP server

Standard export relation diagram