Skip to main content

Incidents

EHS Incidents represent reported or observed safety events within the Intenseye platform — such as injuries, near misses, or environmental issues — that require documentation, review, and potential follow-up actions. The Incident API allows users to retrieve incidents based on various parameters, including status, severity, type, facility, and incident date.

Each API call requires a start and end time defined as Unix timestamps and returns incidents created or updated within the specified time range. The response includes key contextual information such as the incident's location, reporter, approvals, and investigation details, enabling seamless integration with your organization's EHS management or analytics systems.

Unlike alerts, incidents are manually created or reviewed events rather than automatically detected observations. As a result, incident data changes less frequently, and broader query windows can be used without performance concerns, allowing flexible synchronization schedules according to your integration needs.

Export incidents based on time interval​

GET/incident/export

Arguments​

Query String Parameters​
  • start Long required The timestamp where the incidents are happened later
  • end Long required The timestamp where the incidents are happened earlier
  • facilityIds List[String] optional Should be sent as a string list of UUIDs separated by commas
  • status List[Enum] optional
    • OPEN
    • INPROGRESS
    • INAPPROVAL
    • COMPLETED
    • CANCELLED
    • REJECTED
    • APPROVED
    • ARCHIVED
    • HISTORICAL_DATA
    • UNDER_REVIEW
    • SUBMITTED
    • INVESTIGATION
    • CLOSED
  • severity List[Enum] optional
    • LOW
    • MEDIUM
    • HIGH
    • CRITICAL
  • incidentType List[Enum] optional
    • INJURY_ILLNESS
    • NEAR_MISS
    • ENVIRONMENTAL
    • VEHICLE
    • PROPERTY
    • INCIDENT
    • UNSAFE_CONDITION
    • UNSAFE_ACT
    • OBSERVATION
    • SUGGESTION
  • format Enum optional
    • CSV (default)
    • JSON
    • JSONL

Returns​

Returns list of incident objects for given parameters.

FieldTypeDescription
idUUIDUnique identifier of the incident
masterIdUUIDUnique identifier of the master incident
codeStringUnique incident code
facilityIdUUIDUnique identifier of the related facility
nameStringName or title of the incident
statusStringCurrent status of the incident
createdAtStringDate and time when the incident was created
createdByStringEmail address of the user who created the incident
updatedAtStringDate and time when the incident was last updated
updatedByStringEmail address of the user who last updated the incident
bookmarkBooleanShows whether the incident is bookmarked
severityStringSeverity level of the incident (e.g., LOW, MEDIUM, HIGH)
incidentTypeStringType of the incident (e.g., INJURY_ILLNESS, NEAR_MISS, ENVIRONMENTAL)
locationStringLocation where the incident occurred
incidentDateDateTimeDate and time when the incident occurred
involvedPeopleArray(UUID)List of user IDs involved in the incident
approvalsArray(Object)List of approval records associated with the incident
isInvestigatedBooleanIndicates whether the incident has been investigated
reportedByStringEmail address of the user who initially reported the incident
reportedAtDateTimeDate and time when the incident was reported
submittedByStringEmail address of the user who submitted the incident for review
submittedAtDateTimeDate and time when the incident was submitted for review
reviewerStringEmail address of the user responsible for reviewing the incident
reviewStartDateDateTimeDate and time when the review process started
investigatorStringEmail address of the user assigned to investigate the incident
investigationStartDateDateTimeDate and time when the investigation started
investigationDueDateDateTimeDue date for completing the investigation

Approvals objects fields like below:

FieldTypeDescription
idUUIDUnique identifier of the approval record
codeStringApproval code
statusStringCurrent status of the approval (e.g., INAPPROVAL, APPROVED, REJECTED)
createdByEmailStringEmail address of the user who created the approval record
createdAtDateTimeDate and time when the approval record was created
submittedByStringEmail address of the user who submitted the approval
submittedAtDateTimeDate and time when the approval was submitted
recalledByStringEmail address of the user who recalled the approval (if any)
recalledAtDateTimeDate and time when the approval was recalled (if applicable)
  id,masterId,code,facilityId,name,status,createdBy,createdAt,updatedBy,updatedAt,bookmark,severity,incidentType,location,incidentDate,involvedPeople,approvals,isInvestigated,reportedBy,reportedAt,submittedBy,submittedAt,reviewer,reviewStartDate,investigator,investigationStartDate,investigationDueDate
  22f7e672-fceb-4729-87e7-6425b6f4f1e4,098ce362-44cb-423b-a7da-f23d6660d112,INC00010,7200aae3-90d8-480b-a4e9-8fb3eb3af9a6,test-incident-1,OPEN,[email protected],2025-08-12T08:14:12.136014Z,[email protected],2025-08-12T08:14:12.136014Z,false,LOW,INCIDENT,,2025-08-12T05:00Z,"[""303fac9b-8a81-4685-a29e-2ec00ba15e8f"",""874b6514-4afa-4289-8656-b19675e4d48e""]",[],false,,,,,,,,,
  5fa19205-0588-44ff-9bb0-ed90f352a6d7,9c2142e4-a8fa-48a6-85d6-c2f2622e1d83,INC00001,7200aae3-90d8-480b-a4e9-8fb3eb3af9a6,test-incident,OPEN,[email protected],2025-08-11T16:16:25.469641Z,[email protected],2025-08-11T16:16:25.469641Z,false,LOW,INCIDENT,,2025-08-10T00:00Z,"[""303fac9b-8a81-4685-a29e-2ec00ba15e8f"",""874b6514-4afa-4289-8656-b19675e4d48e""]",[],false,,,,,,,,,
  42f7e672-fceb-4729-87e7-6425b6f4f1e4,198ce362-44cb-423b-a7da-f23d6660d112,INC00010,7200aae3-90d8-480b-a4e9-8fb3eb3af9a6,test-incident-2,INPROGRESS,[email protected],2025-08-12T08:14:12.136014Z,[email protected],2025-08-12T08:14:12.136014Z,false,MEDIUM,INCIDENT,,2025-08-13T05:00Z,"[""874b6514-4afa-4289-8656-b19675e4d48e""]","[{""id"":""f12b64a1-e58b-4b61-aa97-7d95d07b898d"",""code"":""APR-TEST-001"",""status"":""INAPPROVAL"",""createdByEmail"":""[email protected]"",""createdAt"":""2025-11-06T10:41:19.931726Z"",""submittedBy"":""[email protected]"",""submittedAt"":""2025-11-06T10:41:19.931726Z"",""recalledBy"":null,""recalledAt"":null}]",false,[email protected],,[email protected],,,,[email protected],,
---