Safety Scores

Safety Score represents Intenseye’s aggregate metric that quantifies overall safety performance within a facility or workspace over time. It consolidates multiple data sources into a single standardized score between 0 and 100. This score provides a clear, comparable measure of safety effectiveness, allowing users to track progress, identify trends, and evaluate the impact of their safety initiatives.

The Safety Score API offers two endpoints: one for facility-level insights and another for workspace-level aggregation. Both endpoints allow querying historical safety performance across custom time ranges defined by start and end Unix timestamps. Optional parameters enable flexible data aggregation by DAY, WEEK, or MONTH, with daily aggregation selected by default. When weekly or monthly aggregation is used, the results automatically align to calendar periods (e.g., Monday–Sunday for weeks or 1st–last day for months), ensuring consistent trend visualization.

The API supports standard output formats (JSON, JSONL, CSV) and can return results either per facility or as consolidated workspace-wide data. By integrating Safety Score into analytics dashboards or reporting tools, organizations can continuously monitor safety improvements, benchmark performance between sites, and make data-driven decisions to enhance workplace safety culture.

Safety scores based on time interval

GET/workspace/score_summary/export

Arguments

Query String Parameters

• start Long required The timestamp where the tasks are happened later
• end Long required The timestamp where the tasks are happened earlier
• aggregate List[Enum] optional
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
• format Enum optional
  • CSV (default)
  • JSON
  • JSONL

Returns

Field	Type	Description
workspaceScoreSummaryCurrent	Double	Current score value of the workspace
workspaceScoreSummaryPrevious	Double	Previous score value of the workspace
percentageChange	Double	Percentage change between current and previous values

Csv

    workspaceScoreSummaryCurrent,workspaceScoreSummaryPrevious,workspaceScoreSummaryPercentageChange
    0.38,0.0,0.0

Json

[
{
  "workspaceScoreSummary": {
    "previous": 0.0,
    "current": 0.38,
    "percentageChange": 0.0
  }
}
]

Json Lines

  {
  "workspaceScoreSummary": {
    "previous": 0.0,
    "current": 0.38,
    "percentageChange": 0.0
  }
  }

---

GET/facility/score_summary/export

Arguments

Query String Parameters

• start Long required The timestamp where the tasks are happened later
• end Long required The timestamp where the tasks are happened earlier
• facilityIds List[String] optional
• aggregate List[Enum] optional
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
• format Enum optional
  • CSV (default)
  • JSON
  • JSONL

Returns

Field	Type	Description
facilityId	String	Unique identifier for facility
facilityName	String	Name of the facility
safetyScore	Double	Safety score value
totalSafetyScore	JSON	Json object that includes previous, current and percentage change values
previous	Double	Previous safety score value by aggregation
current	Double	Current safety score value
percentageChange	Double	Percentage change between current and previous values

Csv

    facilityId,facilityName,facilitySafetyScoreCurrent,facilitySafetyScorePrevious,facilitySafetyScorePercentageChange
    55cccec3-ab94-4805-8a49-166aa31ce845,TEST-Facility-3,0.29,0.44,-0.34
    75cccec3-ab94-4805-8a49-166aa31ce845,TEST-Facility-4,0.0,0.41,-1.0

Json

[
{
  "facilityId": "55cccec3-ab94-4805-8a49-166aa31ce845",
  "facilityName": "TEST-Facility-3",
  "safetyScore": 0.29,
  "totalSafetyScore": {
    "previous": 0.44,
    "current": 0.29,
    "percentageChange": -0.34
  }
},
{
  "facilityId": "75cccec3-ab94-4805-8a49-166aa31ce845",
  "facilityName": "TEST-Facility-4",
  "safetyScore": 0.0,
  "totalSafetyScore": {
    "previous": 0.41,
    "current": 0.0,
    "percentageChange": -1.0
  }
}
]

Json Lines

  {"facilityId":"55cccec3-ab94-4805-8a49-166aa31ce845","facilityName":"TEST-Facility-3","safetyScore":0.29,"totalSafetyScore"{"previous":0.44,"current":0.29,"percentageChange":-0.34}}
  {"facilityId":"75cccec3-ab94-4805-8a49-166aa31ce845","facilityName":"TEST-Facility-4","safetyScore":0,"totalSafetyScore"{"previous":0.41,"current":0,"percentageChange":-1}}

---