Skip to content
Visit the Platform
  • There are no suggestions because the search field is empty.

Task Activity Details API Guide

Task Activity Details API lets you retrieve comprehensive information about a single task activity from our taxonomy — including its name, definition, hierarchy, level, task relationships, and keywords.

This supports in-depth role analysis, system integration, and transformation initiatives.

It empowers teams to connect detailed work elements to broader role frameworks, enabling standardisation and automation readiness.

Who is this API for?

This API is ideal for professionals working at the intersection of workforce architecture, role design, and transformation. In particular:

  • Tech Strategist – analysing specific activity workflows for automation or digital enablement

  • Workforce Planner – mapping task‑activities into HR systems to compare across roles and geographies

  • People Analyst – integrating task‑activity metadata into analytics models and dashboards

  • People Strategist – linking granular activity definitions to broader role designs and salary frameworks

Goals this API helps you achieve

The Task Activity Details API supports key objectives such as:

  • Map data to Pearson’s ontology — by retrieving standard task‑activity definitions to link with internal HR or talent data

  • Standardise roles and salaries — through consistent breakdowns of what people actually do in a role, enabling cross‑role comparison

  • Understand the impact of tech — by examining detailed activities, you can identify automation potential, outsourcing opportunities, or process redesign needs

What’s included in the API?

For a given activity ID, the API returns detailed metadata including:

Field Description
Activity ID Unique identifier of the task activity
Activity Name Descriptive label (e.g., “Prepare financial forecast report”)
Definition Full explanation of what the activity entails
Parent Task Code/Name The higher‑level task to which this activity belongs
Activity Level Hierarchical level or category in the taxonomy
Keywords Synonyms or alternate terms used to describe the activity

This information allows for alignment between internal job/task data and Pearson’s standardised taxonomy, making it easier to compare, integrate, and act on workforce data.

Input and Output

Input required:

  • A Task Activity ID — as defined in Pearson’s taxonomy

  • Optional: Country or Context Filter (in some implementations)

Output includes:

  • Full metadata object of the activity: ID, Name, Definition, Parent Task, Level, Keywords

  • Links or codes to related tasks or activities (for hierarchical navigation)

  • Additional context fields (e.g., synonyms, industry tags) for integration and search‑optimisation

Real‑world applications

Here are examples of how this API is used in strategic workflows:

  • Extract detailed activity definitions to build role‑profiles in HRIS or job architecture tools

  • Align hundreds of job descriptions across geographies by linking to the same standard activity definitions

  • Feed activity‑level analytics to understand where time is spent, enabling automation prioritisation or role redesign

  • Use in conjunction with the Tasks by Occupation API to map how tasks aggregate to roles and inform compensation, workflow or tech decisions

API Bundle

This API is available in the following bundle:

Technology Impact on Workforce – Tailored for organisations focused on role modernisation, process transformation, and workforce design