Persons
Involved persons (suspects, witnesses, employees) - maps to ThinkLP__Investigation_Contact__c.
Person Types:
- Suspect - Primary subjects of investigation
- Witness - Individuals who observed incident
- Employee - Store staff involved or reporting
- Victim, Other - Additional role types
List Persons
List all persons (suspects, witnesses, employees) for a case.
path Parameters
incidentId^[a-zA-Z0-9]{15,18}$ · requiredSalesforce case ID (15/18 chars)
Headers
API-VersionAPI version
List Persons › Responses
List of persons
idnameAuto-generated name (e.g., IC-110)
incident_id^[a-zA-Z0-9]{15,18}$uuidfirst_namelast_namemiddle_nameperson_typedate_of_birthDate in YYYY-MM-DD format (RFC3339 full-date)
genderheightweighthair_coloreye_colorethnicityphone_numberemaildriver_license_numberemployee_idaliasclothingidentifying_featuresapprehension_date_timeISO 8601 date-time (RFC3339)
postal_codeAddress object returned in GET responses (camelCase keys).
POST/PATCH Input: Use flat snake_case fields (address, address_line_2, city, state, postal_code, country). GET Output: Returns this nested camelCase object. Note that postal_code is also returned as a flat field alongside this object.
Field mappings (POST → GET nested):
- address → addressLine1
- address_line_2 → addressLine2
- postal_code → zipCode
- city → city (same)
- state → state (same)
- country → country (same)
Add Person
Add person to case with demographics, contact, and physical details.
path Parameters
incidentId^[a-zA-Z0-9]{15,18}$ · requiredSalesforce case ID (15/18 chars)
Headers
API-VersionAPI version
Add Person › Request Body
first_namelast_namemiddle_nameperson_typedate_of_birthDate in YYYY-MM-DD format (RFC3339 full-date)
genderheightHeight in feet.inches format (e.g., "5.9" for 5'9")
weightWeight in pounds
hair_coloreye_colorethnicityphone_numberemaildriver_license_numberemployee_idaliasclothingidentifying_featuresapprehension_date_timeISO 8601 date-time (RFC3339)
addressFlat address field
address_line_2citystatepostal_codecountryAdd Person › Responses
Resource created successfully
successmessageidIDs of nested entities (if created)
Get Person
path Parameters
incidentId^[a-zA-Z0-9]{15,18}$ · requiredSalesforce case ID (15/18 chars)
personId^[a-zA-Z0-9]{15,18}$ · requiredSalesforce person ID
Headers
API-VersionAPI version
Get Person › Responses
Person details
idnameAuto-generated name (e.g., IC-110)
incident_id^[a-zA-Z0-9]{15,18}$uuidfirst_namelast_namemiddle_nameperson_typedate_of_birthDate in YYYY-MM-DD format (RFC3339 full-date)
genderheightweighthair_coloreye_colorethnicityphone_numberemaildriver_license_numberemployee_idaliasclothingidentifying_featuresapprehension_date_timeISO 8601 date-time (RFC3339)
postal_codeAddress object returned in GET responses (camelCase keys).
POST/PATCH Input: Use flat snake_case fields (address, address_line_2, city, state, postal_code, country). GET Output: Returns this nested camelCase object. Note that postal_code is also returned as a flat field alongside this object.
Field mappings (POST → GET nested):
- address → addressLine1
- address_line_2 → addressLine2
- postal_code → zipCode
- city → city (same)
- state → state (same)
- country → country (same)
Update Person
Partial update of person demographics/contact/notes.
path Parameters
incidentId^[a-zA-Z0-9]{15,18}$ · requiredSalesforce case ID (15/18 chars)
personId^[a-zA-Z0-9]{15,18}$ · requiredSalesforce person ID
Headers
API-VersionAPI version
Update Person › Request Body
first_namelast_namemiddle_nameperson_typedate_of_birthDate in YYYY-MM-DD format (RFC3339 full-date)
genderheightweighthair_coloreye_colorethnicityphone_numberemaildriver_license_numberemployee_idaliasclothingidentifying_featuresapprehension_date_timeISO 8601 date-time (RFC3339)
addressaddress_line_2citystatepostal_codecountryUpdate Person › Responses
Resource updated successfully
successmessageidID of the updated resource
Resource metadata