Skip to main content


This RStudio API guide provides an overview of the ESSENCE APIs and how to access them through RStudio. We will begin with a very brief explanation of application programming interfaces (APIs), then list what APIs are available in ESSENCE, and finally expose you to basic examples of R code and packages so that you can start using RStudio to access ESSENCE data, create your own R Markdown reports and Shiny applications, or do exploratory analyses not possible within ESSENCE. 

Submitted by knowledge_repo… on

Query purpose: 

The objective is to identify visits that likely reflected recreational boating incidents that should have been reported via federal regulation (33 CFR 174.121) to the United States Coast Guard as part of the National Recreational Boating Safety Program. More information on recreational boating incident reporting and statistics can be found on this website:  

Submitted by rtugan on

In 2021, the Council of State and Territorial Epidemiologists (CSTE) and CDC’s NSSP partnered with the National Association for Public Health Statistics and Information Systems (NAPHSIS) and Ruvos on a project to route mortality data through the State and Territorial Exchange of Vital Events (STEVE) into NSSP ESSENCE.

Submitted by aaltabbaa on

Washington State (WA) has developed and recorded three ESSENCE trainings for their staff. These include trainings for basic, intermediate, and advanced ESSENCE skills.

WA ESSENCE Trainings

Submitted by hmccall on

In July 2021, NSSP announced the release of the Rnssp R package which facilitates access to the ESSENCE system via a secure and simple interface. Rnssp provides methods that streamline the data pull and simplify R code previously required by users to pull data via the APIs using the keyring library. In this tutorial demonstrates how to pull data from the ESSENCE system using Rnssp.

Submitted by aaltabbaa on

Background: The Electronic Surveillance System for the Early Notification of Community-Based Epidemics (ESSENCE) is a secure web-based tool that enables health care practitioners to monitor health indicators of public health importance for the detection and tracking of disease outbreaks, consequences of severe weather, and other events of concern.

Submitted by hmccall on


  • July 2023 (Topics: Data Quality Filters, Review of Alert List and Summary Alerts 2.0, Use of sessionAtrributeID for Table Builder API Calls) - Recording
  • June 2023 (Topics: Word Alerts, Text Analysis, New CCDD Categories) - Recording
Submitted by Nathan_Bell on

The NSSP Community of Practice hosted its 6th ESSENCE Q&A session on Monday, July 20, 2020. During the call, Aaron Kite-Powell (CDC) and Wayne Loschen (JHU-APL) provided NSSP-ESSENCE updates and answered the community's questions on ESSENCE functions and features.

View the webinar recording here or via the embedded video above.


The Florida Department of Health (FDOH) previously monitored Florida Poison Information Center (FPICN) data for timely detection of increases in carbon monoxide (CO) exposures before, during, and after hurricanes. Recent analyses have noted that CO poisonings have also increased with generator use and improper heating of homes during cold winter months in Florida. Similarly, increases in CO poisoning cases related to motor vehicles have been observed during summer months. CO is an odorless, colorless, poisonous gas causing sudden illness and death, if present in sufficient concentration in ambient air. The most common signs and symptoms include headache, nausea, lethargy/fatigue, weakness, abdominal discomfort/pain, confusion, and dizziness. This presentation summarizes Florida’s experience in identifying CO poisoning clusters using ESSENCE-based syndromic surveillance.

Submitted by Magou on