...
Search Person
GET /ssp/api/1/person/search
Security
PERSON_SEARCH_READ, PERSON_READ
Parameters
status : ALL, ACTIVE, INACTIVE, DELETED
start : First result (0-based index) to return
limit : Maximum number of results to return
sort : Property name
sortDirection : Ascending/descending keyword (ASC/DESC or ASCENDING/DESCENDING)
Returns
| Code Block |
|---|
{"success" : "true",
"results" : "100",
"rows" :
[{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"createdDate" : 1331269200000,
"createdBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"modifiedDate" : 1331269200000,
"modifiedBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"objectStatus" : "ACTIVE",
"firstName" : "Sally",
"middleInitial" : null,
"lastName" : "Student",
"birthDate" : null,
"primaryEmailAddress" : "sally.student@university.edu",
"secondaryEmailAddress" : null,
"username" : "sally.student",
"userId" : null,
"homePhone" : "123-456-7890",
"workPhone" : null,
"cellPhone" : null,
"addressLine1" : "444 West Third Street",
"addressLine2" : null,
"city" : "Dayton",
"state" : "OH",
"zipCode" : "45402",
"photoUrl" : null,
"schoolId" : null,
"enabled" : false,
"coachId" : "10d6f4f2-cd80-4454-a475-4293dbaff436",
"strengths" : "Good test taker",
"abilityToBenefit" : true,
"anticipatedStartTerm" : "Fall",
"anticipatedStartYear" : "2012",
"studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e",
"specialServiceGroupIds" :
[{"id" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"},
{"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"},
...
],
"referralSourceIds" :
[{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"},
{"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"},
...
],
"serviceReasonIds" :
[{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"},
{"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"},
...
]},
{"id" : "63d62297-bf08-496f-acf3-0c129d437c2b",
"createdDate" : 1331269200000,
"createdBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"modifiedDate" : 1331269200000,
"modifiedBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"objectStatus" : "ACTIVE",
"firstName" : "Bill",
"middleInitial" : null,
"lastName" : "Smith",
"birthDate" : null,
"primaryEmailAddress" : "bill.smith@university.edu",
"secondaryEmailAddress" : null,
"username" : "bill.smith",
"userId" : null,
"homePhone" : "987-65-4321",
"workPhone" : null,
"cellPhone" : null,
"addressLine1" : "110 North Front Street",
"addressLine2" : null,
"city" : "Dayton",
"state" : "OH",
"zipCode" : "45402",
"photoUrl" : null,
"schoolId" : null,
"enabled" : false,
"coachId" : "10d6f4f2-cd80-4454-a475-4293dbaff436"
"strengths" : "Great communication skills",
"abilityToBenefit" : null,
"anticipatedStartTerm" : "Spring",
"anticipatedStartYear" : "2013",
"studentTypeId" : "e34b0d14-f6f0-4adb-85c6-694de9fc0685",
"specialServiceGroupIds" :
[{"id" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"},
{"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"},
...
],
"referralSourceIds" :
[{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"},
{"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"},
...
],
"serviceReasonIds" :
[{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"},
{"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"},
...
]},
...
]
} |
Get a Person
GET /ssp/api/1/person/{id}
Returns
Person
| Code Block |
|---|
{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"createdDate" : 1331269200000,
"createdBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"modifiedDate" : 1331269200000,
"modifiedBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"objectStatus" : "ACTIVE",
"firstName" : "Sally",
"middleInitial" : null,
"lastName" : "Student",
"birthDate" : null,
"primaryEmailAddress" : "sally.student@university.edu",
"secondaryEmailAddress" : null,
"username" : "sally.student",
"userId" : null,
"homePhone" : "123-456-7890",
"workPhone" : null,
"cellPhone" : null,
"addressLine1" : "444 West Third Street",
"addressLine2" : null,
"city" : "Dayton",
"state" : "OH",
"zipCode" : "45402",
"photoUrl" : null,
"schoolId" : null,
"enabled" : false,
"coachId" : "10d6f4f2-cd80-4454-a475-4293dbaff436",
"strengths" : "Good test taker",
"abilityToBenefit" : true,
"anticipatedStartTerm" : "Fall",
"anticipatedStartYear" : "2012",
"studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e",
"specialServiceGroupIds" :
[{"id" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"},
{"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"},
...
],
"referralSourceIds" :
[{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"},
{"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"},
...
],
"serviceReasonIds" :
[{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"},
{"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"},
...
]
} |
Create a Person
POST /ssp/api/1/person
Sample Post
| Code Block |
|---|
{"firstName" : "Sally",
"middleInitial" : null,
"lastName" : "Student",
"birthDate" : null,
"primaryEmailAddress" : "sally.student@university.edu",
"secondaryEmailAddress" : null,
"username" : "sally.student",
"userId" : null,
"homePhone" : "123-456-7890",
"workPhone" : null,
"cellPhone" : null,
"addressLine1" : "444 West Third Street",
"addressLine2" : null,
"city" : "Dayton",
"state" : "OH",
"zipCode" : "45402",
"photoUrl" : null,
"schoolId" : null,
"enabled" : false,
"coachId" : "10d6f4f2-cd80-4454-a475-4293dbaff436",
"strengths" : "Good test taker",
"abilityToBenefit" : true,
"anticipatedStartTerm" : "Fall",
"anticipatedStartYear" : "2012",
"studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e",
"specialServiceGroupIds" :
[{"id" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"},
{"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"},
...
],
"referralSourceIds" :
[{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"},
{"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"},
...
],
"serviceReasonIds" :
[{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"},
{"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"},
...
]
} |
Returns
Person
...
...
Additional Search Criteria:
- programStatus : <programStatusId>, default to Active
- requireProgramStatus: true/false, default to true, force to true is programStatusId is provided
- outsideCaseload : true/false
- searchTerm : Can be firstName, lastName, studentId or firstName + ' ' + lastName
Returns
List<PersonSearchResultTO>
| Code Block |
|---|
{"success":"true", "message":"", "results":1, "rows":[ {"personId":"77fdcb55-05e8-4508-9461-5004b811dbcd", "schoolId":"jwilson219", "firstName":"John", "lastNamemiddleName" : "Doe"}, "modifiedDate" : 1331269200000, "modifiedBy" : {"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280", "Mumford", "firstName" : "John", "lastName" : "Doe"}, "objectStatus" : "ACTIVE", "firstName" : "Sally", "middleInitial" : null, "lastName" : "Student", "birthDate" : null, "primaryEmailAddress" : "sally.student@university.edu", "secondaryEmailAddress" : null, "username" : "sally.student", "userId" : null, "homePhone" : "123-456-7890", "workPhone" : null, "cellPhone" : null, "addressLine1" : "444 West Third Street", "addressLine2" : null, "city" : "Dayton", "state" : "OH", "zipCode" : "45402", "photoUrl" : null, "schoolId" : null, "enabled" : false, "coachId" : "10d6f4f2-cd80-4454-a475-4293dbaff436", "strengths" : "Good test taker", "abilityToBenefit" : true, "anticipatedStartTerm" : "Fall", "anticipatedStartYear" : "2012", "studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e", "specialServiceGroupIds" : [{"id" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"}, {"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"}, ... ], "referralSourceIds" : [{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"}, {"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"}, ... ], "serviceReasonIds" : [{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"}, {"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"}, ... ] } |
Save a Person
PUT /ssp/api/1/person/{id}
Sample Post
| Code Block |
|---|
{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"createdDate" : 1331269200000,
"createdBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"modifiedDate" : 1331269200000,
"modifiedBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"objectStatus" : "ACTIVE",
"firstName" : "Sally",
"middleInitial" : null,
"lastName" : "Student",
"birthDate" : null,
"primaryEmailAddress" : "sally.student@university.edu",
"secondaryEmailAddress" : null,
"username" : "sally.student",
"userId" : null,
"homePhone" : "123-456-7890",
"workPhone" : null,
"cellPhone" : null,
"addressLine1" : "444 West Third Street",
"addressLine2" : null,
"city" : "Dayton",
"state" : "OH",
"zipCode" : "45402",
"photoUrl" : null,
"schoolId" : null,
"enabled" : false,
"coachId" : "10d6f4f2-cd80-4454-a475-4293dbaff436",
"strengths" : "Good test taker",
"abilityToBenefit" : true,
"anticipatedStartTerm" : "Fall",
"anticipatedStartYear" : "2012",
"studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e",
"specialServiceGroupIds" :
[{"id" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"},
{"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"},
...
],
"referralSourceIds" :
[{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"},
{"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"},
...
],
"serviceReasonIds" :
[{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"},
{"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"},
...
]
} |
Returns
Person
| Code Block |
|---|
{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"createdDate" : 1331269200000,
"createdBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"modifiedDate" : 1331269200000,
"modifiedBy" :
{"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
"firstName" : "John",
"lastName" : "Doe"},
"objectStatus" : "ACTIVE",
"firstName" : "Sally",
"middleInitial" : null,
"lastName" : "Student",
"birthDate" : null,
"primaryEmailAddress" : "sally.student@university.edu",
"secondaryEmailAddress" : null,
"username" : "sally.student",
"userId" : null,
"homePhone" : "123-456-7890",
"workPhone" : null,
"cellPhone" : null,
"addressLine1" : "444 West Third Street",
"addressLine2" : null,
"city" : "Dayton",
"state" : "OH",
"zipCode" : "45402",
"photoUrl" : null,
"schoolId" : null,
"enabled" : false,
"coachId" : "10d6f4f2-cd80-4454-a475-4293dbaff436",
"strengths" : "Good test taker",
"abilityToBenefit" : true,
"anticipatedStartTerm" : "Fall",
"anticipatedStartYear" : "2012",
"studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e",
"specialServiceGroupIds" :
[{"id" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"},
{"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"},
...
],
"referralSourceIds" :
[{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"},
{"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"},
...
],
"serviceReasonIds" :
[{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"},
{"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"},
...
]
} |
Delete a Person
DELETE /ssp/api/1/person/{id}
Returns
| Code Block |
|---|
{"success" : "true"} |
or
| Code Block |
|---|
{"success" : "false",
"message" : "Message when success is false."} |
...
GET /ssp/api/1/person/{id}/history/print
Parameters
status : ALL, ACTIVE, INACTIVE, DELETED
start : First result (0-based index) to return
limit : Maximum number of results to return
sort : Property name
sortDirection : Ascending/descending keyword (ASC/DESC or ASCENDING/DESCENDING)
Returns
...
"Wilson",
"birthDate":"1983-08-20",
"studentTypeName":"External",
"currentAppointmentStartTime":null,
"studentIntakeComplete":true,
"numberOfEarlyAlerts":7,
"id":"77fdcb55-05e8-4508-9461-5004b811dbcd",
"coachId":"06f7b046-2239-4a4a-9ee0-030429081962",
"coachFirstName":"Richard",
"coachLastName":"Wilson",
"photoUrl":null,
"currentProgramStatusName":"Active"}
]
} |