Skip to main content

Live Connection Walkthrough

Setting up a live data connection from your LIS or HIS.

A live connection links KantaHub directly to your LIS or HIS via API or database query. Once configured, KantaHub's dashboards update in real time as your LIS receives new data — no manual file uploads required.

Prerequisites​

  • Your LIS must have an accessible API endpoint or read-accessible database
  • Your IT team must provide: API base URL, authentication credentials (API key or username/password), and confirm network access from KantaHub's servers to your LIS
  • KantaHub supports REST APIs and direct PostgreSQL / MySQL / MSSQL read connections

Connection methods​

REST API​

If your LIS exposes a REST API:

  1. Go to Admin → Data Bridge → Live Connection
  2. Select REST API
  3. Enter: API base URL, authentication method (API key / OAuth2 / Basic auth), credentials
  4. Click Test connection — KantaHub fetches a sample payload and confirms the connection
  5. Map the API response fields to KantaHub's expected fields using the field mapper
  6. Set the sync frequency (every 5 minutes, 15 minutes, 30 minutes, or hourly)
  7. Click Save and activate

Direct database read​

If direct database access is preferred:

  1. Select Database connection
  2. Select database type (PostgreSQL, MySQL, Microsoft SQL Server)
  3. Enter: host, port, database name, username, password
  4. Click Test connection
  5. Select the table(s) KantaHub should read from
  6. Map columns to KantaHub's expected fields
  7. Set sync frequency
  8. Click Save and activate
note

KantaHub connects with read-only credentials. It does not write to your LIS database.

After activation​

  • The Data Bridge status panel shows: last sync timestamp, records synced in last run, any sync errors
  • KantaHub dashboards (TAT, Numbers, Tests, Revenue) update automatically after each sync
  • If a sync fails (network error, LIS downtime), KantaHub retries every 5 minutes and alerts the Admin via the notifications panel

Disconnecting​

To pause or remove a live connection:

  1. Go to Admin → Data Bridge → Live Connection
  2. Click Pause (keeps configuration) or Disconnect (removes all connection settings)

Data already imported is not deleted when a connection is paused or removed.

For live connection setup, email [email protected] — our team will assist with mapping your LIS API to KantaHub's data model.