The LRS API

The LRS API

Veracity Learning has many tools, features, and functions that users can exercise. While many of these features are available through the user interface, you may wish to automate some of the functionality of your LRS. You can accomplish this via the LRS API. Don't confuse this with the xAPI - the LRS API is not for collection learner performance data. Instead, you can use the LRS API to create and remove learners, lessons, and other data objects in the system, or to launch content.

API Keys

In order to talk to the API for your LRS, you'll first need to allocate a new API Key. This key should be placed in the x-veracity-api-key header of your HTTP request. Hits against the LRS API counts against your daily API call limit exactly as hits on the xAPI do.

To create an API key, navigate to "All Management Tools". Then, find the "API keys" link.


When you click this link, you'll get a page that allows you to create or delete API keys. Click on the green button to add a new API key.






From here, you can choose a name and a permission level. Choose the values you prefer from the form, and click OK. You can now use the API key to automate your LRS. We will generate a unique value for the key.


Connecting to the API

The API is available at http://yourlrs.lrs.io/api. This will change with the name of your LRS and the server options, if you are serving locally. You must place the value of your API key in a header. The name of the header should be x-veracity-api-key.

Using the API

In general, you can GET, PUT, POST or DELETE to the endpoints for each data model. Issuing a GET to the top level of the data model will allow search and pagination. Read the documentation below for the technical details.

LRS API Documentation

Click Here to view the complete LRS API Documentation using Swagger.




    • Related Articles

    • The System API

      The on-premises install of the Enterprise version of Veracity Learning includes a system level API for creating users and LRSs. This API works exactly as the LRS level does, with the same conventions for GET, PUT, POST and DELETE. You'll find the API ...
    • LRS Management

      Veracity Learning LRS gives you many tools to manage your LRS and the data in it. These include backup and restore features, import and export features, as well as tools to update, migrate and modify the data in the LRS. LRS Management Basics Now ...
    • LMS Integration

      The Veracity Learning offers seamless integration with your LMS to allow instructors and students to access the services of the LRS without leaving their LMS environment. This is accomplished via LTI (Learning Tools Interoperability), a standard from ...
    • Advanced Search and Aggregation

      Veracity exposes a few extensions to the xAPI interfaces that allow you additional options for querying and analyzing data. xAPI Advanced Search The xAPI search interface from the official specification can be somewhat.... limiting. Our expanded ...
    • Veracity Learning Basics

      Veracity Learning is an easy to use, cloud or self hosted Learning Record Store (LRS). The most essential feature of an LRS is that it receives and processes eXperience API (xAPI) data transactions. xAPI is a new standard for moving around ...