Not logged in - Login

API Example Create Person


The Safe system, for Persons, is built on the premise of a Unique Person. We want, if possible, to avoid having multiple people in the system that are actually the same person. Before submitting a new Person, you should check to see if that person is already in the system. See notes below for 'Duplicate Persons Detection'

Fields used in Post

  • All Fields in the JSON example are Text-based fields and not required unless listed in the following rows.

  • ID [Required and must be 0]

  • First Name & Last Name OR Business Name [Required, Text]

  • RaceID [Required Integer]
    • GET (1 = Unknown, 2 = African American or Black, 3 = American Indian or Alaska Native, 4 = Asian, 5 = Native Hawaiian or Other Pacific Islander, 6 = White, 7 = Hispanic, 8 = Middle Eastern)

  • DOB [Not required, Date / Time]

  • Active [Required, True or False]

  • Deceased [Required, True or False (Submit as False if unknown)]

  • Juvenile [Required, True or False (Submit as False if unknown)]

  • ID, Date & EntityID (Address Field) [These are all placeholders and submitted values will not be used]

Example JSON For Adding A Person

       "businessName":"Tracker Products",
       "alias":"Big Bob",
       "line1":"1 Symphony Way",

Duplicate Person Detection

When submitting a Person via POST, we are doing a check for potential duplicate people in the system. We check the following fields to determine if a potential duplicate exists:
Driver's License
Business Name
Duplicate Name (FirstName LastName)

If when posting a Person that is considered a duplicate, you will get this response.

At this point you can do one of two things:

Person Post With Custom Form Data

When creating a new person in the system, a post can also include custom form data. Here is an example post of a person with a custom form:
POST Person With Form Data

Add Person to Case after Submit

To Add the Person submitted to an Existing Case, take the ID returned in the Person Post and go to Attach Existing Person to Existing Case