Embedded Files
Need help? Chat with our Support Team!
API URL
https://securelb.trackerproducts.com/api/people/X
Where X = ID of Person
Instructions
To update a person in the system, the user must go through the following process:
Get the ID of the person they wish to update
Using the person id, retrieve the person record from the database
Make changes and submit PUT for the edited person
Get ID of the person to update
A simple search can return a matching person based on name (any part of first, last, and business name will return results). Also, an email address can be used to accomplish this search (As a reminder, the email address in the system is unique which may be the best way to find a particular person).
Also, please see the following page for a more comprehensive search of people in the system: Custom Person SearchÂ
The endpoint which can be used is the type-ahead search. Note that this search will only return a list of 10 people at one time, so the search should be as specific as possible.
https://securelb.trackerproducts.com/api/people/typeahead?search=X
Where X = Last Name OR Email Address of Person.
Using ID to get all info on the Person
https://securelb.trackerproducts.com/api/people/X
Where X = ID of person found in previous setp
This returns the person document:
PUT the Person
Take all the JSON information provided in the previous step, change and then PUT back to https://securelb.trackerproducts.com/api/people/X
Where X = ID of the Person being updated
Example JSON for Person PUT
{
       "id":96,
       "guid":"9993788e-fcc1-47f4-8ca7-abc71dff3aa8",
       "organizationId":275,
       "userId":null,
       "createDateTime":"2017-12-04T22:49:00.927Z",
       "updatedDateTime":null,
       "isDeleted":null,
       "businessName":"",
       "businessNameLC":"",
       "name":"Johannes Brahms",
       "nameLC":"johannes brahms",
       "firstName":"Johannes",
       "firstNameLC":"johannes",
       "middleName":"",
       "middleNameLC":null,
       "lastName":"Brahms",
       "lastNameLC":"brahms",
       "alias":"Joe",
       "aliasLC":"joe",
       "driverLicence":"",
       "mobilePhone":"888-888-8888",
       "otherPhone":"123-777-1234",
       "email":"",
       "dob":"1959-01-01T00:00:00.000Z",
       "raceId":27,
       "race":"White",
       "genderId":12,
       "gender":"Male",
       "deceased":false,
       "juvenile":false,
       "active":true,
       "personTypeId":null,
       "formData":[],
       "formDataAmount":0,
       "notes":[],
       "notesAmount":0,
       "media":[],
       "mediaAmount":0,
       "rootMediaFolderId":175,
       "displayedName":" Johannes Brahms",
       "defaultAddress":"1 Somewhere Ave, , Vienna, , 1006"
}
PUTing a Duplicate Person
Entering a duplicate person via a PUT action is handled the same as the POST of a new person. See detailsÂ
Use this API if you are PUTing a Duplicate person. https://securelb.trackerproducts.com/api/people/putDuplicate
PUT a Person with custom form data
Custom form data can also be added to a person record
The first step in this process is retrieving custom forms.
GET
https://securelb.trackerproducts.com/api/forms/all
This will return data for all custom forms in your organization.
here is a sample of the return data:
Using ID to get all info on the Person
https://securelb.trackerproducts.com/api/people/X
Where X = ID of person found in previous setp
This returns the person document:
PUT the Person
Take all the JSON information provided in the previous step, change and then PUT back to https://securelb.trackerproducts.com/api/people/X
Where X = ID of the Person being updated
Example JSON for Person PUT
{
       "id":96,
       "guid":"9993788e-fcc1-47f4-8ca7-abc71dff3aa8",
       "organizationId":275,
       "userId":null,
       "createDateTime":"2017-12-04T22:49:00.927Z",
       "updatedDateTime":null,
       "isDeleted":null,
       "businessName":"",
       "businessNameLC":"",
       "name":"Johannes Brahms",
       "nameLC":"johannes brahms",
       "firstName":"Johannes",
       "firstNameLC":"johannes",
       "middleName":"",
       "middleNameLC":null,
       "lastName":"Brahms",
       "lastNameLC":"brahms",
       "alias":"Joe",
       "aliasLC":"joe",
       "driverLicence":"",
       "mobilePhone":"888-888-8888",
       "otherPhone":"123-777-1234",
       "email":"",
       "dob":"1959-01-01T00:00:00.000Z",
       "raceId":27,
       "race":"White",
       "genderId":12,
       "gender":"Male",
       "deceased":false,
       "juvenile":false,
       "active":true,
       "personTypeId":null,
       "formData":[],
       "formDataAmount":0,
       "notes":[],
       "notesAmount":0,
       "media":[],
       "mediaAmount":0,
       "rootMediaFolderId":175,
       "displayedName":" Johannes Brahms",
       "defaultAddress":"1 Somewhere Ave, , Vienna, , 1006"
}
PUTing a Duplicate Person
Entering a duplicate person via a PUT action is handled the same as the POST of a new person. See detailsÂ
Use this API if you are PUTing a Duplicate person. https://securelb.trackerproducts.com/api/people/putDuplicate
PUT a Person with custom form data
Custom form data can also be added to a person record
The first step in this process is retrieving custom forms.
GET
https://securelb.trackerproducts.com/api/forms/all
This will return data for all custom forms in your organization.
here is a sample of the return data:
The data to note here is the form id and the name of the custom form field.
For example, form id : 819, form name is "Test2", field name is "field4627" I will now update a person record to include this custom form data.
PUT back to https://securelb.trackerproducts.com/api/people/1634911
Custom form data is added in the formData property.
Here is my request:
{
"id": 1634865,
"guid": "6fdbb17f-1722-48dd-85e4-7fef0a6be5ab",
"organizationId": 1,
"userId": null,
"createDateTime": "2018-03-26T14:45:09.908Z",
"updatedDateTime": "2018-08-03T12:56:25.113Z",
"isDeleted": null,
"businessName": "",
"businessNameLC": "",
"name": "Crazy Person",
"nameLC": "crazy person",
"firstName": "Crazy",
"firstNameLC": "crazy",
"middleName": "",
"middleNameLC": null,
"lastName": "Person",
"lastNameLC": "person",
"alias": "",
"aliasLC": "",
"driverLicence": "",
"mobilePhone": "",
"otherPhone": "",
"email": "",
"dob": null,
"raceId": 1,
"race": "Unknown",
"genderId": 1,
"gender": "Unknown",
"deceased": false,
"juvenile": false,
"active": true,
"personTypeId": null,
"formData": [
{
"formId": 819,
"formName": "Test2",
"data": "{\"field4627\":\"Sample Legal Hold Status\"}",
"entityId": "1634865",
"dateFields": [ ]
}
],
"formDataAmount": 0,
"notes": [ ],
"notesAmount": 0,
"media": [ ],
"mediaAmount": 0,
"rootMediaFolderId": 133677,
"externalOrganizationIds": [ ],
"displayedName": "Crazy Person",
"defaultAddress": "910 E Watersville Road, , Mt. Airy, Maryland, ",
"isForbidden": false
}
POST a Person address
An address can be added for a person by :
POST to:
https://securelb.trackerproducts.com/api/people/1634950/addresses
Here is the json for the POST body:
{
"id": 0,
"date": "2018-09-25T18:42:49.218Z",
"entityId": 1634950,
"line1": "111 First Street",
"line2": "Suite 1",
"city": "Cincinnati",
"zip": "11111",
"stateId": 35,
"addressTypeId": 1,
"countryId": 231
}
Things to note for posting an address:
"entityId" is the person id for whom the address is being added
"id" is required and should be set to a value of 0 - the added address will be assigned an "id" by the system.
"stateId", "addressTypeId", and "countryId" are all supplied in the body by reference to their corresponding integer ids. Here are the GET requests for these items:
https://securelb.trackerproducts.com/api/states
https://securelb.trackerproducts.com/api/countries
https://securelb.trackerproducts.com/api/addressTypes
GET and PUT a Person address
To get the addresses associated with a person record use the following GET request:
https://securelb.trackerproducts.com/api/people/1634950/addresses
This will return the following data: [ {
"id": 1090834,
"createDateTime": "2018-09-25T19:18:05.937+00:00",
"updatedDateTime": null,
"isDeleted": null,
"entityId": 1634991,
"line1": "701 Overton St",
"line2": "",
"city": "Newport",
"zip": "41071",
"date": "2018-09-25T19:17:19.679+00:00",
"stateId": 17,
"state": null,
"countryId": 231,
"country": null,
"addressTypeId": 1,
"addressType": null,
"isDefaultAddress": true
}
]
To edit this address, use the following PUT request:
https://securelb.trackerproducts.com/api/people/1634991/addresses/1090834
Notice the url contains the person "id" and also the address "id"
Also, "country", "addressType", and "state" can be removed. You can just send the ids for these fields.
Here is the body of my address edit: {
"id": 1090834,
"createDateTime": "2018-09-25T19:18:05.937+00:00",
"updatedDateTime": null,
"isDeleted": null,
"entityId": 1634991,
"line1": "701 Overton St",
"line2": "",
"city": "Somewhere",
"zip": "41071",
"date": "2018-09-25T19:17:19.679+00:00",
"stateId": 35,
"countryId": 231,
"addressTypeId": 1,
"isDefaultAddress": true
}
Page updated
Report abuse