---
sourceDocument: Yokohama Employee Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/employee-service-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Employee Service Management

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

# Get employee or visitor health data

# Get employee or visitor health data {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Send a GET request for Employee Health and Safety Status data to use in your third-party system. Get data to determine an employee or visitor's current health status.

## Before you begin

Role required: sn_imt_core.reader

## Procedure

Send a GET request to the Table API on your instance.  
For more information, see [Table API](https://www.servicenow.com/docs/access?context=c_TableAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US).

1. Construct the endpoint using the Health and Safety User \[sn_imt_core_health_and_safety_user\] table.  

       https://<your-instance>.servicenow.com/api/now/table/sn_imt_core_health_and_safety_user

2. Add a query parameter to query a specific user's email address.  
   In the API explorer, you can enter one of the following strings in the sysparm_query field to generate an endpoint that includes the correct query parameter:
   * <kbd class="ph userinput">user.email=&lt;user-email-address&gt;</kbd>: Queries the provided employee's email address.
   * <kbd class="ph userinput">visitor.email=&lt;visitor-email-address&gt;</kbd>: Queries the provided visitor's email address.

   {#query-health-data__ul_glp_mhq_3mb}

{#query-health-data__substeps_ctd_bwh_3mb}  
This example cURL request queries the Health and Safety User table and returns records associated with Abel Tuter's email address.

    curl "http://<your-instance>.servicenow.com/api/now/table/sn_imt_core_health_and_safety_user?sysparm_query=user.email%3Dabel.tuter%40example.com&sysparm_limit=1" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

## Result

The Employee Health and Safety Status application returns the Health and Safety User record associated with the email address in the request. The JSON payload contains the following data.

    {
      "result": [
        {
          "sys_mod_count": "0",
          "sys_updated_on": "2020-07-14 19:58:00",
          "sys_tags": "",
          "type": "employee",
          "sys_id": "33f184491bce9010e3730e16ec4bcb71",
          "sys_updated_by": "system.administrator",
          "manually_created": "true",
          "sys_created_on": "2020-07-14 19:58:00",
          "sys_domain": {
            "link": "https://<my-instance>.servicenow.com/api/now/table/sys_user_group/global",
            "value": "global"
          },
          "requirements_status": "cleared",
          "visitor": "",
          "user": {
            "link": "https://<my-instance>.servicenow.com/api/now/table/sys_user/62826bf03710200044e0bfc8bcbe5df1",
            "value": "62826bf03710200044e0bfc8bcbe5df1"
          },
          "sys_created_by": "system.administrator"
        }
      ]
    }

All
fields are internal, except for the following:  
{#query-health-data__table_avk_r4p_3mb__entry__2}

| Property | Description |
|-|-|
| requirements_status | Whether the visitor or employee has completed all requirements to return to the workplace. For more information, see [Create health and safety user records](https://www.servicenow.com/docs/hfbsmeXBisVDKq4nxe63YA "Create health and safety user records to track requirement statuses for all employees and visitors.") and [Create a health and safety requirement](https://www.servicenow.com/docs/JgFU5itK3myidiSnAzGALA "Create requirements to track when employees are ready to return to the workplace or visit a site. You can also create requirements that visitors must complete before entering the workplace."). * Cleared: The visitor or employee has completed all requirements to return to the workplace. * Not Cleared: The visitor or employee has not completed all requirements to return to the workplace. {#query-health-data__ul_qdm_1vp_3mb} Data type: String |
| visitor | If present, this record represents a visitor instead of an employee. Note: Only used when returning visitor health data. Data type: Object |
| visitor.link | Link to the visitor record on the instance. Note: Only used when returning visitor health data. Data type: String |
| visitor.value | Sys_id of the visitor record. Note: Only used when returning visitor health data. Data type: String |
| user | If present, this record represents an employee instead of a visitor. Note: Only used when returning employee health data. Data type: Object |
| user.link | Link to the user record on the instance. Note: Only used when returning employee health data. Data type: String |
| user.value | Sys_id of the user record. Note: Only used when returning employee health data. Data type: String |
[ ]

{#query-health-data__table_avk_r4p_3mb}