Watershed Integration APIs Overview

Watershed is a learning analytics platform that provides actionable insights from your training and performance data. Built using modern practices for data processing and cloud-based platforms, we provide several APIs that allow you to integrate Watershed with external applications.

These APIs allow outside applications to access a wide range of Watershed’s capabilities, including:

  • sending data into the learning record store (LRS);
  • retrieving aggregated report data; and
  • managing core entities—such as organizational metadata, dashboards, reports, accomplishments, and accounts.

API Authentication

Our family of REST APIs are made accessible through a secure SSL connection over HTTP, using basic authentication. See How do I add an activity provider to Watershed? You are able to choose if credentials have access to the LRS API, the Reporting API or both. 


Conforming with the core Experience API (xAPI) specification, our LRS API allows applications to interact with the data in your LRS using the standardized xAPI communication protocol.

The Statements API provides the ability to add and retrieve xAPI interaction statements, void statements, and search for statements by agent, activity, or context data.

The Agent, Activity, and State APIs allow for flexible data to be stored and retrieved from an LRS. These key-value stores let applications manage stateful data about an agent, activity, or a combination of the two.

Reporting API

Our Reporting API demonstrates one of Watershed’s most valuable capabilities: aggregating xAPI and organizational data into reporting results that provide insights. Some of the features made possible by the Reporting API include:

  • Data retrieval for an existing report or set of reports created through the Watershed application
  • A highly flexible query and Aggregation API to filter, group, and sort data according to any fields available in your LRS or organizational data
  • Valuable reports such as:
    • activity timelines,
    • score results,
    • assessment question analysis,
    • learning program results,
    • and many more.

Any person or group of people in your organization can filter these reports. Furthermore, reports are filtered according to the specific account holder’s permissions, which can be modified via the Watershed interface or our Groups API.

Dashboards API

Our Dashboard API allows outside applications to save and organize reports using dashboards and reports while also allowing users to see these reports in the Watershed interface. With this API, for example, an integrated application can create a new activity report for the most active courses in its library or manage dashboards for each group of users present in the application.

Groups API

The Groups API enables outside HR systems or employee data record systems to import and modify data about the people and groups in your organization. Examples of data that can be imported include:

  • Organizational hierarchy (e.g., teams, divisions, regions)
  • Functional groups (e.g., managers, sales staff, production staff)
  • Location-based groups (e.g., United States, Europe, Asia)
  • Any other flat or hierarchical set of groups

Group information can be used in any of the reports provided by Watershed, such that aggregated data can be filtered, categorized, or sorted according to groups. Additionally, the Groups API manages reporting permissions, which are then automatically used across all reporting capabilities.

Data Import and Export APIs

Our Data Import API allows applications to import data that is not already in the standard xAPI format. Specifically, the CSV format can be used to import data that has been exported from another system or tool into Watershed. This API allows outside systems to import data on a regular schedule and provides a great avenue for bringing important data into Watershed.

The Export API allows applications to download the full set of xAPI data from the LRS in the form of JSON or CSV, which can then be accessed with other external tools or sent to another LRS. The API also has the ability to create connections with other LRSs that automatically import or export data on a regular schedule.


Administration APIs

Additional APIs exist for managing other aspects of Watershed, such as:

  • Credentials and permissions for Learning Record Provider accounts
  • Account membership and permissions for an organization
  • Profile information for an authenticated account
  • Organization information, such as name and logo
  • Debug logging for the LRS
Was this article helpful?
0 out of 0 found this helpful

If you can't find what you need or you want to ask a real person a question, please contact customer support.