Liongard is an API-first product, meaning that ALL functionality of the Liongard platform is exposed via our REST API.

Currently, we are working toward a v2 of our API which will be more consistent and easy to use. Until then, we have published documentation on the most common v1 routes that our partners integrate with to get you started working with the API.

📘

Accessing the API

In order to access our API you will need a Liongard Account, If you are interested in building an integration with out product and need an account feel free to reach out to our team here and tell us a bit about your company and integration interests!

Working with the Liongard API

  1. Getting familiar with Liongard Terminology
  2. Learning how to Authenticate to the Liongard API
  3. Working with the Liongard v1 API
  4. Best practice when working with Metrics
  5. Download and try out our endpoints via our Postman Collection

Liongard Terminology and Data Model

Below are some common terminology that you will encounter working with Liongard as well as how our data flows within the API

Terminology

  • Environments - An environment in Liongard represents a single end customer for your Company. An environment will contain Agents, Launchpoints (configured inspections), and Systems (data that has landed as a result of an inspection).
  • Agents - Agents can be installed in the Cloud or On-Premise and are responsible for running inspections.
  • Inspector - An Inspector represents the system type and is used for building the config templates for launchpoints.
  • Launchpoint - A Launchpoint is a configured Inspection. As an example, if you set up a domain inspector to run on liongard.com, that would be considered a Launchpoint.
  • System - A System in Liongard represents a system that has been inspected by a Launchpoint. When the inspection completes for the first time, a system is completed and a corresponding timeline entry is created each time the inspection lands.
  • Timeline - A Timeline entry represents a single inspection event. It links a System to its configuration at that point in time.
  • Detection - A Detection is a Change that was detected on a system.
  • Alerts - An Alert is raised when an Alert Rule condition is met by an inspection.
  • Metrics - Are queries that can be written to extract a piece of information from a system to create an Alert, Change Detection, or Report.

Data Model

Below we have included a simplified diagram explaining the basic data model of Liongard so you can start familiarizing yourself with the terms you will see in the API.

Liongard Support

If you need help or have any questions with our API, reach out to our support team:

Liongard Support: Chat with Support.

👍

Next

Authentication