ThinkLP
ThinkLP Case Management API

DateOnly

string · date

Date in YYYY-MM-DD format (RFC3339 full-date)

TimeLocal

string · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

DateTime

string · date-time

ISO 8601 date-time (RFC3339)

AddressNested

Address 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)
addressLine1
​string
addressLine2
​string
city
​string
state
​string
zipCode
​string
country
​string

CaseSummary

Case summary returned in GET /incidents (list view)
id
​string · readOnly
incident_type
​string
investigation_type
​string
incident_number
​string · readOnly
location_number
​string

External identifier for Location (Account) via ThinkLP__Location_Number__c

location_id
​string · pattern: ^[a-zA-Z0-9]{15,18}$
narrative
​string · maxLength: 32000
status
​string
total_estimated_value
​number · readOnly

Calculated sum of all stolen items

incident_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

incident_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

report_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

report_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

police_department
​string · maxLength: 100
police_report_number
​string · maxLength: 25
police_officer_name
​string · maxLength: 50
concealment_method
​string
concealment_location
​string
uuid
​string · uuid · readOnly
last_modified_date
​DateTime · date-time · readOnly

ISO 8601 date-time (RFC3339)

CaseDetail

Case summary returned in GET /incidents (list view)
id
​string · readOnly
incident_type
​string
investigation_type
​string
incident_number
​string · readOnly
location_number
​string

External identifier for Location (Account) via ThinkLP__Location_Number__c

location_id
​string · pattern: ^[a-zA-Z0-9]{15,18}$
narrative
​string · maxLength: 32000
status
​string
total_estimated_value
​number · readOnly

Calculated sum of all stolen items

incident_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

incident_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

report_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

report_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

police_department
​string · maxLength: 100
police_report_number
​string · maxLength: 25
police_officer_name
​string · maxLength: 50
concealment_method
​string
concealment_location
​string
uuid
​string · uuid · readOnly
last_modified_date
​DateTime · date-time · readOnly

ISO 8601 date-time (RFC3339)

​PersonDetail[]
​VehicleDetail[]
​ItemDetail[]

CreateCase

Case creation payload (POST /incidents). ## Field Categories **Read-Only Fields (Ignored if Sent):** - `incident_number` - AutoNumber field (format: `C-{number}`) - `total_estimated_value` - Roll-up from Case Items - `total_recovered_value` - Roll-up from recovered Case Items - Audit fields: `created_date`, `last_modified_date`, etc. **Date/Time Handling:** - Preferred: `incident_local_date` + `incident_local_time` (separate fields) - Alternative: `incident_date_time` (ISO 8601 combined) - Default: If only date provided, time = midnight **Record Type:** - Determined by the integration user's default Case record type - `record_type` is not accepted in the payload **Location Fields (Lookup Precedence):** - `location_number` - External identifier (for lookup) - `location_id` - Direct Salesforce ID - **Rule:** If both provided, `location_id` takes precedence **Value Fields:** - `initial_case_value` - Writable estimate at creation - Total case value auto-calculated from Case Items (read-only) **Extensibility:** Field mappings configured via Custom Metadata (`DomainMapping__mdt`). Additional fields beyond spec will be processed per your org's config.
incident_type
​string
investigation_type
​string
narrative
​string · maxLength: 32000
status
​string
location_number
​string

External identifier for Location

location_id
​string · pattern: ^[a-zA-Z0-9]{15,18}$
concealment_location
​string
concealment_method
​string
incident_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

incident_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

report_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

report_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

police_report_number
​string · maxLength: 25
police_department
​string · maxLength: 100
police_officer_name
​string · maxLength: 50
stage
​string · writeOnly

Case stage (accepted in POST/PATCH, never returned in GET)

source
​string · writeOnly

Case source (accepted in POST/PATCH, never returned in GET)

outcome
​string · writeOnly

Case outcome (accepted in POST/PATCH, never returned in GET)

incident_category
​string · writeOnly

Incident category (accepted in POST/PATCH, never returned in GET)

incident_location
​string · writeOnly

Incident location (accepted in POST/PATCH, never returned in GET)

initial_case_value
​number · writeOnly

Initial case value (accepted in POST/PATCH, never returned in GET)

total_recovered_value
​number · writeOnly

Total recovered value (accepted in POST/PATCH, never returned in GET)

incident_date_time
​DateTime · date-time · writeOnly

ISO 8601 date-time (RFC3339)

report_date_time
​DateTime · date-time · writeOnly

ISO 8601 date-time (RFC3339)

closed_date_time
​DateTime · date-time · writeOnly

ISO 8601 date-time (RFC3339)

police_officer_badge_number
​string · writeOnly

Police officer badge number (accepted in POST/PATCH, never returned in GET)

police_notified
​boolean · writeOnly

Whether police were notified (accepted in POST/PATCH, never returned in GET)

case_owner
​string · writeOnly

Case owner User/Queue Id (15/18 chars). If omitted, defaults to integration user.

investigator
​string · writeOnly

Investigator (accepted in POST/PATCH, never returned in GET)

priority
​string · writeOnly

Case priority (accepted in POST/PATCH, never returned in GET)

external_id
​string · writeOnly

External system ID (accepted in POST/PATCH, never returned in GET)

external_owner
​string · writeOnly

External owner (accepted in POST/PATCH, never returned in GET)

​CreatePerson[]
​CreateVehicle[]
​CreateItem[]

UpdateCase

Case update payload (PATCH /incidents/{id}). ## PATCH Semantics **Field Handling:** - **Omitted fields**: Preserved (not modified) - **Null values**: Clear the field (set to null in database) - **Provided values**: Update the field - **ReadOnly fields**: Ignored if sent (incident_number, total_estimated_value, audit fields) **Nested Entities:** To update persons/vehicles/items, use dedicated child endpoints (not supported in case PATCH). **Response:** Returns UpdatedResponse with id, attributes, success, message.
incident_type
​string
investigation_type
​string
narrative
​string · maxLength: 32000
status
​string
location_number
​string

External identifier for Location

location_id
​string · pattern: ^[a-zA-Z0-9]{15,18}$
concealment_location
​string
concealment_method
​string
incident_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

incident_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

report_local_date
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

report_local_time
​TimeLocal · pattern: ^([01]\d|2[0-3]):[0-…

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

police_report_number
​string · maxLength: 25
police_department
​string · maxLength: 100
police_officer_name
​string · maxLength: 50
stage
​string · writeOnly
source
​string · writeOnly
outcome
​string · writeOnly
incident_category
​string · writeOnly
incident_location
​string · writeOnly
initial_case_value
​number · writeOnly
total_recovered_value
​number · writeOnly
incident_date_time
​DateTime · date-time · writeOnly

ISO 8601 date-time (RFC3339)

report_date_time
​DateTime · date-time · writeOnly

ISO 8601 date-time (RFC3339)

closed_date_time
​DateTime · date-time · writeOnly

ISO 8601 date-time (RFC3339)

police_officer_badge_number
​string · writeOnly
police_notified
​boolean · writeOnly
case_owner
​string · writeOnly

Case owner User/Queue Id (15/18 chars). If omitted, defaults to integration user.

investigator
​string · writeOnly
priority
​string · writeOnly
external_id
​string · writeOnly
external_owner
​string · writeOnly

PersonDetail

Person details returned in GET responses
id
​string · readOnly
name
​string · readOnly

Auto-generated name (e.g., IC-110)

incident_id
​string · readOnly · pattern: ^[a-zA-Z0-9]{15,18}$
uuid
​string · uuid · readOnly
first_name
​string · maxLength: 50
last_name
​string · maxLength: 50
middle_name
​string · maxLength: 50
person_type
​string
date_of_birth
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

gender
​string
height
​string
weight
​number
hair_color
​string
eye_color
​string
ethnicity
​string
phone_number
​string
email
​string · email
driver_license_number
​string
employee_id
​string
alias
​string
clothing
​string
identifying_features
​string
apprehension_date_time
​DateTime · date-time

ISO 8601 date-time (RFC3339)

postal_code
​string · maxLength: 10
​AddressNested

Address 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)

CreatePerson

Person creation payload (POST). Address fields flat (snake_case).
first_name
​string · maxLength: 50
last_name
​string · maxLength: 50
middle_name
​string · maxLength: 50
person_type
​string
date_of_birth
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

gender
​string
height
​string

Height in feet.inches format (e.g., "5.9" for 5'9")

weight
​number · min: 0

Weight in pounds

hair_color
​string
eye_color
​string
ethnicity
​string
phone_number
​string
email
​string · email
driver_license_number
​string
employee_id
​string
alias
​string
clothing
​string
identifying_features
​string
apprehension_date_time
​DateTime · date-time

ISO 8601 date-time (RFC3339)

address
​string · maxLength: 75

Flat address field

address_line_2
​string · maxLength: 75
city
​string · maxLength: 50
state
​string
postal_code
​string · maxLength: 10
country
​string · maxLength: 80

UpdatePerson

Person update payload (PATCH /incidents/{incident_id}/persons/{id}). ## PATCH Semantics - **Omitted fields**: Preserved (not modified) - **Null values**: Clear the field - **Provided values**: Update the field **Response**: Returns full UpdatedResponse with id, attributes, success, message.
first_name
​string · maxLength: 50
last_name
​string · maxLength: 50
middle_name
​string · maxLength: 50
person_type
​string
date_of_birth
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

gender
​string
height
​string
weight
​number
hair_color
​string
eye_color
​string
ethnicity
​string
phone_number
​string
email
​string · email
driver_license_number
​string
employee_id
​string
alias
​string
clothing
​string
identifying_features
​string
apprehension_date_time
​DateTime · date-time

ISO 8601 date-time (RFC3339)

address
​string · maxLength: 75
address_line_2
​string · maxLength: 75
city
​string · maxLength: 50
state
​string
postal_code
​string · maxLength: 10
country
​string · maxLength: 80

VehicleDetail

Vehicle details returned in GET responses
id
​string · readOnly
name
​string · readOnly

Auto-generated name (e.g., IC-109)

incident_id
​string · readOnly · pattern: ^[a-zA-Z0-9]{15,18}$
uuid
​string · uuid · readOnly
make
​string
model
​string
year
​string
color
​string
license_plate
​string
license_state
​string

CreateVehicle

Vehicle creation payload (POST)
make
​string
model
​string
year
​string
color
​string
license_plate
​string
license_state
​string

UpdateVehicle

Vehicle update payload (PATCH /incidents/{incident_id}/vehicles/{id}). ## PATCH Semantics - **Omitted fields**: Preserved (not modified) - **Null values**: Clear the field - **Provided values**: Update the field **Response**: Returns full UpdatedResponse with id, attributes, success, message.
make
​string
model
​string
year
​string
color
​string
license_plate
​string
license_state
​string

ItemDetail

Item details returned in GET responses
id
​string · readOnly
name
​string · readOnly

Auto-generated name (e.g., CI-41)

incident_id
​string · readOnly · pattern: ^[a-zA-Z0-9]{15,18}$
involved_person_id
​string · pattern: ^[a-zA-Z0-9]{15,18}$
uuid
​string · uuid · readOnly
category
​string
description
​string
quantity
​number
retail_price
​number
upc
​string
sku
​string
unit_type
​string
serial_number
​string

CreateItem

Item creation payload (POST)
involved_person_id
​string · pattern: ^[a-zA-Z0-9]{15,18}$
category
​string
description
​string
quantity
​number
retail_price
​number
upc
​string · pattern: ^\d{12}$

Universal Product Code (12-digit barcode number)

sku
​string · maxLength: 50

Stock Keeping Unit (internal product code)

unit_type
​string
serial_number
​string

UpdateItem

Item update payload (PATCH /incidents/{incident_id}/items/{id}). ## PATCH Semantics - **Omitted fields**: Preserved (not modified) - **Null values**: Clear the field - **Provided values**: Update the field **Response**: Returns full UpdatedResponse with id, attributes, success, message.
involved_person_id
​string · pattern: ^[a-zA-Z0-9]{15,18}$
category
​string
description
​string
quantity
​number
retail_price
​number
upc
​string
sku
​string
unit_type
​string
serial_number
​string

SalesforceError

Individual error object in Salesforce platform error responses (401, 429).
message
​string · required

Human-readable error message

errorCode
​string · required

Machine-readable error code

ErrorEnvelope

Standard error envelope for application-controlled error responses (400, 404, 500).
error
​string · required

Detailed error description

message
​string · required

Human-readable error message

success
​boolean · required

Always false for error responses

SuccessResponse

success
​boolean
message
​string

CreatedResponse

success
​boolean
message
​string
id
​string
​object
​object

IDs of nested entities (if created)

UpdatedResponse

Response for successful PATCH operations. Returns the updated resource ID and attributes.
success
​boolean
message
​string
id
​string

ID of the updated resource

​object

Resource metadata