...
The programStatus that is returned is the currently assigned program status. Use the Person Program Status API to select all program statuses for the person.
Get All Persons
GET /ssp/api/1/person
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 |
---|
Info |
Changelog:
|
Info |
---|
The function of "combined" ObjectStatus values produce a top-level ObjectStatus value for an entity which might itself be associated with other statused entities. E.g. a Person is associated with zero or more SpecialServiceGroups. Each individual association is actually represented by a third entity: PersonSpecialServiceGroups. This enables the application to support soft-deletes of these associations, which is potentially useful for reporting. But it creates a problem for the UI, which should suppress display of any PersonSpecialServiceGroup where either it or the associated SpecialServiceGroup has been set into a deleted ObjectStatus. The follow reference items persist throughout the application and are handled by the ObjectStatus functionality;
|
Get All Persons
GET /ssp/api/1/person
Security
PERSON_READ
Parameters
status : ALL, ACTIVE, INACTIVE
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 |
---|
{
"id":"d77f4697-ed36-4477-b8d0-67c9a1d8b2db",
"createdDate":1356998400000,
"createdBy":{
"id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e",
"firstName":"Demo",
"lastName":"Coach13",
"fullName":"Demo Coach13"
},
"modifiedDate":1444021202117,
"modifiedBy":{
"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"firstName":"System",
"lastName":"Administrator",
"fullName":"System Administrator"
},
"objectStatus":"ACTIVE",
"firstName":"James",
"middleName":"Jacob",
"lastName":"Anderson",
"birthDate":"1986-10-24",
"primaryEmailAddress":"demo@trainingssp.com",
"secondaryEmailAddress":"",
"username":"janderson218",
"homePhone":"(555) 555-5412",
"workPhone":"",
"cellPhone":"",
"alternatePhone":"212-555-1212",
"nonLocalAddress":false,
"addressLine1":"321 W. Demo St.",
"addressLine2":"Apt. 214",
"city":"Phoenix",
"state":"AZ",
"zipCode":"55555 ",
"alternateAddressInUse":false,
"alternateAddressLine1":"",
"alternateAddressLine2":"",
"alternateAddressCity":"",
"alternateAddressState":" ",
"alternateAddressZipCode":" ",
"alternateAddressCountry":"",
"photoUrl":null,
"schoolId":"janderson218",
"enabled":true,
"studentIntakeCompleteDate":null,
"studentType":{
"id":"0a640a2a-409d-1271-8140-d0af4a4200ef",
"name":"Non-Degree Seeking",
"objectStatus":"ACTIVE"
},
"coach":{
"id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e",
"firstName":"Demo",
"lastName":"Coach13",
"primaryEmailAddress":"demo@trainingssp.com",
"workPhone":"(777) 777-7777",
"officeLocation":null,
"departmentName":null,
"homeCampusName":"West Campus",
"photoUrl":null
},
"abilityToBenefit":true,
"anticipatedStartTerm":"",
"anticipatedStartYear":2011,
"actualStartTerm":"FA2011",
"actualStartYear":2011,
"studentIntakeRequestDate":1440076505197,
"specialServiceGroups":[
{
"id":"856a3600-1326-11e2-9b79-406c8f22c3ce",
"name":"Student Athlete",
"objectStatus":"ACTIVE"
},
{
"id":"0a640a2a-409d-1271-8140-d0c138a100fd",
"name":"DEI Focus Group",
"objectStatus":"ACTIVE"
}
],
"referralSources":[
{
"id":"859ff107-1326-11e2-8698-406c8f22c3ce",
"name":"Student Conduct",
"objectStatus":"ACTIVE"
},
{
"id":"858b0cab-1326-11e2-818e-406c8f22c3ce",
"name":"HS Guidance Counselor",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"Faculty / Staff Referral",
"objectStatus":"ACTIVE"
},
{
"id":"ccadd634-bd7a-11e1-8d28-3368721922dc",
"name":"Ombudsman",
"objectStatus":"ACTIVE"
}
],
"serviceReasons":[
{
"id":"0a640a2a-409d-1271-8140-d0b3878000f6",
"name":"Scholarship Recipient",
"objectStatus":"ACTIVE"
},
{
"id":"85709794-1326-11e2-8bab-406c8f22c3ce",
"name":"Academically Unprepared",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"At-Risk Student",
"objectStatus":"ACTIVE"
},
{
"id":"205df6c0-fea0-11e1-9678-406c8f22c3ce",
"name":"Career Coaching",
"objectStatus":"ACTIVE"
}
],
"confidentialityLevels":null,
"permissions":null,
"currentProgramStatusName":"Active",
"programStatusChangeReasonName":null,
"registeredForCurrentTerm":false,
"activeAlertsCount":2,
"closedAlertsCount":1,
"residencyCounty":"DemoCounty",
"f1Status":"Y",
"gender":"M",
"maritalStatus":"Separated",
"ethnicity":null,
"race":null,
"actionPlanTaskOpenCount":1,
"actionPlanTaskClosedCount":4,
"lastActionPlanCompletedDate":1440076479537,
"confidentialityDisclosureAgreementSignedDate":1440076476617,
"homeCampus":{
"id":"901e104b-4dc7-43f5-a38e-581015e204e1",
"name":"North Campus",
"objectStatus":"ACTIVE"
},
"formattedCDACompleteDate":"2015-08-20",
"formattedStudentIntakeCompleteDate":null
} |
Get All Persons Who Are Coaches
This method calls the corresponding uPlatform API to obtain those individuals assigned the Coach group.
Info |
---|
For performance reasons, this result set is populated by a background job that by default runs every 5m. The background job and known issues with user attribute caching in uPortal affect how quickly the coach list in uPortal is updated. |
GET /ssp/api/1/person/coach
Security
PERSON_READ
Returns
List<PersonLiteTO>
Returns
Code Block |
---|
{"success" : "true",
"results" : "100",
"rows" :
[{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"firstName" : "Camden",
"lastName" : "Coach"},
{"id" : "63d62297-bf08-496f-acf3-0c129d437c2b",
"firstName" : "Christina",
"lastName" : "Coach"},
...
]
} |
Get a Person
GET /ssp/api/1/person/{id}
Security
PERSON_READ
Returns
Person
Code Block |
---|
{
"id":"d77f4697-ed36-4477-b8d0-67c9a1d8b2db",
"createdDate":1356998400000,
"createdBy":{
"id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e",
"firstName":"Demo",
"lastName":"Coach13",
"fullName":"Demo Coach13"
},
"modifiedDate":1444021202117,
"modifiedBy":{
"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"firstName":"System",
"lastName":"Administrator",
"fullName":"System Administrator"
},
"objectStatus":"ACTIVE",
"firstName":"James",
"middleName":"Jacob",
"lastName":"Anderson",
"birthDate":"1986-10-24",
"primaryEmailAddress":"demo@trainingssp.com",
"secondaryEmailAddress":"",
"username":"janderson218",
"homePhone":"(555) 555-5412",
"workPhone":"",
"cellPhone":"",
"alternatePhone":"212-555-1212",
"nonLocalAddress":false,
"addressLine1":"321 W. Demo St.",
"addressLine2":"Apt. 214",
"city":"Phoenix",
"state":"AZ",
"zipCode":"55555 ",
"alternateAddressInUse":false,
"alternateAddressLine1":"",
"alternateAddressLine2":"",
"alternateAddressCity":"",
"alternateAddressState":" ",
"alternateAddressZipCode":" ",
"alternateAddressCountry":"",
"photoUrl":null,
"schoolId":"janderson218",
"enabled":true,
"studentIntakeCompleteDate":null,
"studentType":{
"id":"0a640a2a-409d-1271-8140-d0af4a4200ef",
"name":"Non-Degree Seeking",
"objectStatus":"ACTIVE"
},
"coach":{
"id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e",
"firstName":"Demo",
"lastName":"Coach13",
"primaryEmailAddress":"demo@trainingssp.com",
"workPhone":"(777) 777-7777",
"officeLocation":null,
"departmentName":null,
"homeCampusName":"West Campus",
"photoUrl":null
},
"abilityToBenefit":true,
"anticipatedStartTerm":"",
"anticipatedStartYear":2011,
"actualStartTerm":"FA2011",
"actualStartYear":2011,
"studentIntakeRequestDate":1440076505197,
"specialServiceGroups":[
{
"id":"856a3600-1326-11e2-9b79-406c8f22c3ce",
"name":"Student Athlete",
"objectStatus":"ACTIVE"
},
{
"id":"0a640a2a-409d-1271-8140-d0c138a100fd",
"name":"DEI Focus Group",
"objectStatus":"ACTIVE"
}
],
"referralSources":[
{
"id":"859ff107-1326-11e2-8698-406c8f22c3ce",
"name":"Student Conduct",
"objectStatus":"ACTIVE"
},
{
"id":"858b0cab-1326-11e2-818e-406c8f22c3ce",
"name":"HS Guidance Counselor",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"Faculty / Staff Referral",
"objectStatus":"ACTIVE"
},
{
"id":"ccadd634-bd7a-11e1-8d28-3368721922dc",
"name":"Ombudsman",
"objectStatus":"ACTIVE"
}
],
"serviceReasons":[
{
"id":"0a640a2a-409d-1271-8140-d0b3878000f6",
"name":"Scholarship Recipient",
"objectStatus":"ACTIVE"
},
{
"id":"85709794-1326-11e2-8bab-406c8f22c3ce",
"name":"Academically Unprepared",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"At-Risk Student",
"objectStatus":"ACTIVE"
},
{
"id":"205df6c0-fea0-11e1-9678-406c8f22c3ce",
"name":"Career Coaching",
"objectStatus":"ACTIVE"
}
],
"confidentialityLevels":null,
"permissions":null,
"currentProgramStatusName":"Active",
"programStatusChangeReasonName":null,
"registeredForCurrentTerm":false,
"activeAlertsCount":2,
"closedAlertsCount":1,
"residencyCounty":"DemoCounty",
"f1Status":"Y",
"gender":"M",
"maritalStatus":"Separated",
"ethnicity":null,
"race":null,
"actionPlanTaskOpenCount":1,
"actionPlanTaskClosedCount":4,
"lastActionPlanCompletedDate":1440076479537,
"confidentialityDisclosureAgreementSignedDate":1440076476617,
"homeCampus":{
"id":"901e104b-4dc7-43f5-a38e-581015e204e1",
"name":"North Campus",
"objectStatus":"ACTIVE"
},
"formattedCDACompleteDate":"2015-08-20",
"formattedStudentIntakeCompleteDate":null
} |
Get a Person by School ID
Selects a single person by their school id. The school id is typically the person's unique institutional id stored in the ERP system.
GET /ssp/api/1/person/bySchoolId/{schoolId}
Security
PERSON_READ
Returns
Person
Code Block |
---|
{
"id":"d77f4697-ed36-4477-b8d0-67c9a1d8b2db",
"createdDate":1356998400000,
"createdBy":{
"id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e",
"firstName":"Demo",
"lastName":"Coach13",
"fullName":"Demo Coach13"
},
"modifiedDate":1444021202117,
"modifiedBy":{
"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
"firstName":"System",
"lastName":"Administrator",
"fullName":"System Administrator"
},
"objectStatus":"ACTIVE",
"firstName":"James",
"middleName":"Jacob",
"lastName":"Anderson",
"birthDate":"1986-10-24",
"primaryEmailAddress":"demo@trainingssp.com",
"secondaryEmailAddress":"",
"username":"janderson218",
"homePhone":"(555) 555-5412",
"workPhone":"",
"cellPhone":"",
"alternatePhone":"212-555-1212",
"nonLocalAddress":false,
"addressLine1":"321 W. Demo St.",
"addressLine2":"Apt. 214",
"city":"Phoenix",
"state":"AZ",
"zipCode":"55555 ",
"alternateAddressInUse":false,
"alternateAddressLine1":"",
"alternateAddressLine2":"",
"alternateAddressCity":"",
"alternateAddressState":" ",
"alternateAddressZipCode":" ",
"alternateAddressCountry":"",
"photoUrl":null,
"schoolId":"janderson218",
"enabled":true,
"studentIntakeCompleteDate":null,
"studentType":{
"id":"0a640a2a-409d-1271-8140-d0af4a4200ef",
"name":"Non-Degree Seeking",
"objectStatus":"ACTIVE"
},
"coach":{
"id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e",
"firstName":"Demo",
"lastName":"Coach13",
"primaryEmailAddress":"demo@trainingssp.com",
"workPhone":"(777) 777-7777",
"officeLocation":null,
"departmentName":null,
"homeCampusName":"West Campus",
"photoUrl":null
},
"abilityToBenefit":true,
"anticipatedStartTerm":"",
"anticipatedStartYear":2011,
"actualStartTerm":"FA2011",
"actualStartYear":2011,
"studentIntakeRequestDate":1440076505197,
"specialServiceGroups":[
{
"id":"856a3600-1326-11e2-9b79-406c8f22c3ce",
"name":"Student Athlete",
"objectStatus":"ACTIVE"
},
{
"id":"0a640a2a-409d-1271-8140-d0c138a100fd",
"name":"DEI Focus Group",
"objectStatus":"ACTIVE"
}
],
"referralSources":[
{
"id":"859ff107-1326-11e2-8698-406c8f22c3ce",
"name":"Student Conduct",
"objectStatus":"ACTIVE"
},
{
"id":"858b0cab-1326-11e2-818e-406c8f22c3ce",
"name":"HS Guidance Counselor",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"Faculty / Staff Referral",
"objectStatus":"ACTIVE"
},
{
"id":"ccadd634-bd7a-11e1-8d28-3368721922dc",
"name":"Ombudsman",
"objectStatus":"ACTIVE"
}
],
"serviceReasons":[
{
"id":"0a640a2a-409d-1271-8140-d0b3878000f6",
"name":"Scholarship Recipient",
"objectStatus":"ACTIVE"
},
{
"id":"85709794-1326-11e2-8bab-406c8f22c3ce",
"name":"Academically Unprepared",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"At-Risk Student",
"objectStatus":"ACTIVE"
},
{
"id":"205df6c0-fea0-11e1-9678-406c8f22c3ce",
"name":"Career Coaching",
"objectStatus":"ACTIVE"
}
],
"confidentialityLevels":null,
"permissions":null,
"currentProgramStatusName":"Active",
"programStatusChangeReasonName":null,
"registeredForCurrentTerm":false,
"activeAlertsCount":2,
"closedAlertsCount":1,
"residencyCounty":"DemoCounty",
"f1Status":"Y",
"gender":"M",
"maritalStatus":"Separated",
"ethnicity":null,
"race":null,
"actionPlanTaskOpenCount":1,
"actionPlanTaskClosedCount":4,
"lastActionPlanCompletedDate":1440076479537,
"confidentialityDisclosureAgreementSignedDate":1440076476617,
"homeCampus":{
"id":"901e104b-4dc7-43f5-a38e-581015e204e1",
"name":"North Campus",
"objectStatus":"ACTIVE"
},
"formattedCDACompleteDate":"2015-08-20",
"formattedStudentIntakeCompleteDate":null
} |
Create a Person
POST /ssp/api/1/person
Security
PERSON_WRITE
Note
Properties currentAppointmentStartDate and currentProgramStatusName are helper properties and are not saved if specified. Call the respective Person Appointment and Person Program Status services to save these entries.
Sample Post
Code Block |
---|
{ "firstName":"James",
"middleName":"Jacob",
"lastName":"Anderson",
"birthDate":"1986-10-24",
"primaryEmailAddress":"demo@trainingssp.com",
"secondaryEmailAddress":"",
"username":"janderson218",
"homePhone":"(555) 555-5412",
"workPhone":"",
"cellPhone":"",
"alternatePhone":"212-555-1212",
"nonLocalAddress":false,
"addressLine1":"321 W. Demo St.",
"addressLine2":"Apt. 214",
"city":"Phoenix",
"state":"AZ",
"zipCode":"55555 ",
"alternateAddressInUse":false,
"alternateAddressLine1":"",
"alternateAddressLine2":"",
"alternateAddressCity":"",
"alternateAddressState":" ",
"alternateAddressZipCode":" ",
"alternateAddressCountry":"",
"photoUrl":null,
"schoolId":"janderson218",
"enabled":true,
"studentIntakeCompleteDate":null,
"studentType":{
"id":"0a640a2a-409d-1271-8140-d0af4a4200ef",
"name":"Non-Degree Seeking",
"objectStatus":"ACTIVE"
},
"coach":{
"id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e",
"firstName":"Demo",
"lastName":"Coach13",
"primaryEmailAddress":"demo@trainingssp.com",
"workPhone":"(777) 777-7777",
"officeLocation":null,
"departmentName":null,
"homeCampusName":"West Campus",
"photoUrl":null
},
"abilityToBenefit":true,
"anticipatedStartTerm":"",
"anticipatedStartYear":2011,
"actualStartTerm":"FA2011",
"actualStartYear":2011,
"studentIntakeRequestDate":1440076505197,
"specialServiceGroups":[
{
"id":"856a3600-1326-11e2-9b79-406c8f22c3ce",
"name":"Student Athlete",
"objectStatus":"ACTIVE"
},
{
"id":"0a640a2a-409d-1271-8140-d0c138a100fd",
"name":"DEI Focus Group",
"objectStatus":"ACTIVE"
}
],
"referralSources":[
{
"id":"859ff107-1326-11e2-8698-406c8f22c3ce",
"name":"Student Conduct",
"objectStatus":"ACTIVE"
},
{
"id":"858b0cab-1326-11e2-818e-406c8f22c3ce",
"name":"HS Guidance Counselor",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"Faculty / Staff Referral",
"objectStatus":"ACTIVE"
},
{
"id":"ccadd634-bd7a-11e1-8d28-3368721922dc",
"name":"Ombudsman",
"objectStatus":"ACTIVE"
}
],
"serviceReasons":[
{
"id":"0a640a2a-409d-1271-8140-d0b3878000f6",
"name":"Scholarship Recipient",
"objectStatus":"ACTIVE"
},
{
"id":"85709794-1326-11e2-8bab-406c8f22c3ce",
"name":"Academically Unprepared",
"objectStatus":"ACTIVE"
},
{
"id":"f6201a04-bb31-4ca5-b606-609f3ad09f87",
"name":"At-Risk Student",
"objectStatus":"ACTIVE"
},
{
"id":"205df6c0-fea0-11e1-9678-406c8f22c3ce",
"name":"Career Coaching",
"objectStatus":"ACTIVE"
}
],
"confidentialityLevels":null,
"permissions":null,
"currentProgramStatusName":"Active",
"programStatusChangeReasonName":null,
"registeredForCurrentTerm":false,
"activeAlertsCount":2,
"closedAlertsCount":1,
"residencyCounty":"DemoCounty",
"f1Status":"Y",
"gender":"M",
"maritalStatus":"Separated",
"ethnicity":null,
"race":null,
"actionPlanTaskOpenCount":1,
"actionPlanTaskClosedCount":4,
"lastActionPlanCompletedDate":1440076479537,
"confidentialityDisclosureAgreementSignedDate":1440076476617,
"homeCampus":{
"id":"901e104b-4dc7-43f5-a38e-581015e204e1",
"name":"North Campus",
"objectStatus":"ACTIVE"
},
"formattedCDACompleteDate":"2015-08-20",
"formattedStudentIntakeCompleteDate":null
} |
Returns
Person
Code Block |
---|
{ "id":"d77f4697-ed36-4477-b8d0-67c9a1d8b2db", "createdDate":1356998400000, "createdBy":{ "id":"22fc02f1-d8b6-496c-8e2d-65f6973f888e", "firstName":"Demo", "lastName":"Coach13", "fullName":"Demo Coach13" }, "modifiedDate":1444021202117, "modifiedBy":{ "id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41", "firstName":"System", "lastName":"Administrator", "fullName":"System Administrator" }, "objectStatus":"ACTIVE", "firstName":"James", "middleName":"Jacob", "lastName":"Anderson", "birthDate":"1986-10-24", "primaryEmailAddress":"demo@trainingssp.com", "secondaryEmailAddress":"", "username":"janderson218", "homePhone":"(555) 555-5412", "workPhone":"", "cellPhone":"", "alternatePhone":"212-555-1212", "nonLocalAddress":false, "addressLine1":"321 W. Demo St.", "addressLine2":"Apt. 214", "city":"Phoenix", "state":"AZ", "zipCode":"55555 ", "alternateAddressInUse":false, "alternateAddressLine1":"", "alternateAddressLine2":"", "alternateAddressCity":"", "alternateAddressState":" ", "alternateAddressZipCode":" ", "alternateAddressCountry":"", "photoUrl":null, "schoolId":"janderson218", "enabled":true, "studentIntakeCompleteDate":null, "studentType":{ {"id" : "91f46e390a640a2a-cea8409d-422b1271-b2158140-00f6bcf5d280d0af4a4200ef", "name":"Non-Degree Seeking", "firstNameobjectStatus" : "JohnACTIVE" }, "coach":{ "lastNameid" : "Doe"}"22fc02f1-d8b6-496c-8e2d-65f6973f888e", "modifiedDatefirstName" : 1331269200000"Demo", "modifiedBylastName" :"Coach13", {"idprimaryEmailAddress" : "91f46e39-cea8-422b-b215-00f6bcf5d280", "demo@trainingssp.com", "firstNameworkPhone" :"(777) 777-7777"John", "officeLocation":null, "lastName" : "DoedepartmentName"}:null, "objectStatushomeCampusName" :"West "ACTIVECampus", "firstNamephotoUrl" :null "Sally", }, "middleInitialabilityToBenefit" : nulltrue, "lastNameanticipatedStartTerm" : "Student", "birthDateanticipatedStartYear" : null2011, "primaryEmailAddressactualStartTerm" : "sally.student@university.eduFA2011", "actualStartYear":2011, "secondaryEmailAddressstudentIntakeRequestDate" : null1440076505197, "specialServiceGroups":[ "username" : "sally.student", { "userId" : null, "homePhoneid" : "123-456-7890856a3600-1326-11e2-9b79-406c8f22c3ce", "workPhonename" :"Student nullAthlete", "cellPhoneobjectStatus" :"ACTIVE" null, }, "addressLine1" : "444 West Third Street", { "addressLine2" : null, "cityid" : "Dayton"0a640a2a-409d-1271-8140-d0c138a100fd", "state" : "OH", "zipCode" : "45402",name":"DEI Focus Group", "photoUrl "objectStatus":"ACTIVE" : null, } "schoolId" : null], "enabledreferralSources":[ : false, { "coach" : {"id" : "91f46e39859ff107-cea81326-422b11e2-b2158698-00f6bcf5d280406c8f22c3ce", "firstNamename" :"Student "AmyConduct", "lastNameobjectStatus" : "Advisor"ACTIVE" }, { "strengths" : "Good test taker", "abilityToBenefit" : true,"id":"858b0cab-1326-11e2-818e-406c8f22c3ce", "name"anticipatedStartTerm:"HS :Guidance Counselor"Fall", "anticipatedStartYear" : "2012", "studentTypeIdobjectStatus" : "ce0d041d-d3ac-42a1-9085-7f744240e07e","ACTIVE" "studentIntakeRequestDate"}, : 1331269200000, { "currentAppointment" : {"id" : ""f6201a04-bb31-4ca5-b606-609f3ad09f87", "name"startDate:"Faculty / :Staff 1331269200000Referral", "endDate" : 1331269200000"objectStatus":"ACTIVE" }, "specialServiceGroupIds" : { [{"id" : "437f6f2bccadd634-7b1ebd7a-47b411e1-86038d28-9e1208605c0d3368721922dc"}, {"idname" : "7bf36968-ad48-4c5f-9838-ebf495713c08"}"Ombudsman", ..."objectStatus":"ACTIVE" } ], "serviceReasons":[ "referralSourceIds" : { [{"id" : "a8c83fd40a640a2a-ee33409d-46ee1271-8d898140-9b2956696f37d0b3878000f6"}, {"idname" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"}"Scholarship Recipient", ... "objectStatus":"ACTIVE" ]}, "serviceReasonIds"{ : [{"id" : "d95ea02985709794-90c11326-4be011e2-b5478bab-8054fc6914b7406c8f22c3ce"}, {"idname" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"}"Academically Unprepared", ..."objectStatus":"ACTIVE" }, ], { "programStatus" : {"id" : "acf7d721f6201a04-196fbb31-43534ca5-9508b606-fe86c61e3c1d609f3ad09f87", "name" :"At-Risk Student"Active"}},, {"idobjectStatus" : "63d62297-bf08-496f-acf3-0c129d437c2b","ACTIVE" "createdDate"}, : 1331269200000, { "createdBy" : {"id" : "91f46e39205df6c0-cea8fea0-422b11e1-b2159678-00f6bcf5d280406c8f22c3ce", "firstNamename" :"Career "JohnCoaching", "lastNameobjectStatus" : "Doe"},ACTIVE" } ], "modifiedDateconfidentialityLevels" :null, 1331269200000, "permissions":null, "modifiedBycurrentProgramStatusName" :"Active", "programStatusChangeReasonName":null, "registeredForCurrentTerm":false, {"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280"activeAlertsCount":2, "closedAlertsCount":1, "firstNameresidencyCounty" : "JohnDemoCounty", "f1Status":"Y", "lastNamegender" : "DoeM"}, "objectStatusmaritalStatus" : "ACTIVESeparated", "ethnicity":null, "firstNamerace":null, : "BillactionPlanTaskOpenCount":1, "actionPlanTaskClosedCount":4, "middleInitiallastActionPlanCompletedDate" :1440076479537, null, "confidentialityDisclosureAgreementSignedDate":1440076476617, "lastNamehomeCampus":{ : "Smith", "birthDate" : null"id":"901e104b-4dc7-43f5-a38e-581015e204e1", "primaryEmailAddressname" :"North Campus"bill.smith@university.edu", "secondaryEmailAddressobjectStatus" :"ACTIVE" null, }, "usernameformattedCDACompleteDate" : "bill.smith"2015-08-20", "userId" : null, "homePhone" : "987-65-4321"formattedStudentIntakeCompleteDate":null } |
Save a Person
PUT /ssp/api/1/person/{id}
Security
PERSON_WRITE
Note
Properties currentAppointmentStartDate and currentProgramStatusName are helper properties and are not saved if specified. Call the respective Person Appointment and Person Program Status services to save these entries.
Sample Post
Code Block |
---|
{ "id":"d77f4697-ed36-4477-b8d0-67c9a1d8b2db", "workPhonecreatedDate" : null1356998400000, "cellPhonecreatedBy" :{ null, "addressLine1" : "110 North Front Street", "addressLine2" : null, "city" : "Dayton", "stateid" : "OH"22fc02f1-d8b6-496c-8e2d-65f6973f888e", "zipCodefirstName" : "45402Demo", "photoUrllastName" : null"Coach13", "fullName"schoolId:"Demo :Coach13" null, }, "enabledmodifiedDate" : false1444021202117, "coachmodifiedBy" : { {"id" : "91f46e3958ba5ee3-cea8734e-422b4ae9-b215b9c5-00f6bcf5d280943774b4de41", "firstName" : "AmySystem", "lastName" : "Advisor"}, "strengths" : "Great communication skills"Administrator", "fullName"abilityToBenefit:"System :Administrator" null, }, "anticipatedStartTermobjectStatus" : "SpringACTIVE", "firstName":"James", "anticipatedStartYearmiddleName" : "2013Jacob", "lastName":"Anderson", "studentTypeIdbirthDate" : "e34b0d141986-f6f0-4adb-85c6-694de9fc068510-24", "primaryEmailAddress":"demo@trainingssp.com", "studentIntakeRequestDatesecondaryEmailAddress" :"", null, "username":"janderson218", "currentAppointmenthomePhone" :"(555) 555-5412", "workPhone":"", {"idcellPhone" : "", "alternatePhone":"212-555-1212", "nonLocalAddress":false, "startDateaddressLine1" :"321 1331269200000,W. Demo St.", "addressLine2":"Apt. 214", "endDatecity" : 1331269200000},"Phoenix", "state":"AZ", "zipCode"specialServiceGroupIds:"55555 : ", "alternateAddressInUse":false, [{"idalternateAddressLine1" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"}, "alternateAddressLine2":"", {"idalternateAddressCity" : "7bf36968-ad48-4c5f-9838-ebf495713c08"}, "alternateAddressState":" ", ..."alternateAddressZipCode":" ", ], "alternateAddressCountry":"", "referralSourceIdsphotoUrl" :null, "schoolId":"janderson218", "enabled":true, [{"idstudentIntakeCompleteDate":null, : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"}, studentType":{ {"id" : "55aebdf70a640a2a-466b409d-49c41271-a08c8140-6e01eaf101d7d0af4a4200ef"}, "name":"Non-Degree Seeking", ... "objectStatus":"ACTIVE" ]}, "serviceReasonIdscoach" :{ [{"id" : "d95ea02922fc02f1-90c1d8b6-4be0496c-b5478e2d-8054fc6914b765f6973f888e"}, "firstName":"Demo", {"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"}, "lastName":"Coach13", "primaryEmailAddress":"demo@trainingssp.com", "workPhone":"(777) 777-7777", ... "officeLocation":null, ]"departmentName":null, "programStatushomeCampusName" :"West Campus", {"idphotoUrl" : "e8f6a45b-79ce-4687-831c-ca5f190dddc3",null }, "abilityToBenefit":true, "nameanticipatedStartTerm" : "Non-participating"}}, "anticipatedStartYear":2011, ... ] } |
Get a Person
GET /ssp/api/1/person/{id}
Returns
Person
Code Block |
---|
{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41", "createdDate" : 1331269200000, "createdBy" : "actualStartTerm":"FA2011", "actualStartYear":2011, "studentIntakeRequestDate":1440076505197, "specialServiceGroups":[ { "id" : "91f46e39856a3600-cea81326-422b11e2-b2159b79-00f6bcf5d280406c8f22c3ce", "firstNamename" :"Student Athlete"John", "lastNameobjectStatus" : "Doe"ACTIVE" }, "modifiedDate" : 1331269200000, "modifiedBy" : { {"id" : "91f46e390a640a2a-cea8409d-422b1271-b2158140-00f6bcf5d280d0c138a100fd", "firstName" : "John "name":"DEI Focus Group", "lastName" : "Doe"}, "objectStatus" : "ACTIVE", "firstName" : "Sally", "middleInitial"} : null, "lastName"], : "Student", "birthDatereferralSources":[ : null, "primaryEmailAddress" : "sally.student@university.edu", "secondaryEmailAddress" :{ null, "username" : "sally.student", "userId" : null, "homePhoneid" : "123-456-7890859ff107-1326-11e2-8698-406c8f22c3ce", "workPhone" : null, "cellPhone" : null, "addressLine1name" :"Student Conduct"444, West Third Street", "addressLine2" : null, "cityobjectStatus" : "DaytonACTIVE", "state" : "OH", "zipCode" : "45402"}, "photoUrl" : null, "schoolId" : null,{ "enabled" : false, "coach" : {"id" : "91f46e39858b0cab-cea81326-422b11e2-b215818e-00f6bcf5d280406c8f22c3ce", "firstName" : "Amy", "name":"HS Guidance Counselor", "lastNameobjectStatus" : "AdvisorACTIVE"}, "strengths" : "Good test taker"}, "abilityToBenefit" : true, "anticipatedStartTerm" : "Fall", "anticipatedStartYear" : "2012", "studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e", "studentIntakeRequestDate" : 1331269200000, "currentAppointment" : { "id":"f6201a04-bb31-4ca5-b606-609f3ad09f87", "name":"Faculty / Staff Referral", {"idobjectStatus" : "ACTIVE", "startDate"}, : 1331269200000, { "endDate" : 1331269200000}, "specialServiceGroupIds" : [{"id" : "437f6f2bccadd634-7b1ebd7a-47b411e1-86038d28-9e1208605c0d3368721922dc"}, {"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08"}, "name":"Ombudsman", "objectStatus":"ACTIVE" ... } ], "referralSourceIdsserviceReasons" ::[ { [{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"}, {"id" : "55aebdf70a640a2a-466b409d-49c41271-a08c8140-6e01eaf101d7d0b3878000f6"}, ... ]"name":"Scholarship Recipient", "serviceReasonIds" : [{"idobjectStatus" : "d95ea029-90c1-4be0-b547-8054fc6914b7"},"ACTIVE" {"id" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"}, ... { ], "programStatus" : {"id" : "acf7d72185709794-196f1326-435311e2-95088bab-fe86c61e3c1d406c8f22c3ce", "name" :"Academically Unprepared"Active"} } |
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, "coach" : {"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",, "objectStatus":"ACTIVE" }, { "id":"f6201a04-bb31-4ca5-b606-609f3ad09f87", "name":"At-Risk Student", "objectStatus":"ACTIVE" }, { "id":"205df6c0-fea0-11e1-9678-406c8f22c3ce", "firstNamename" :"Career "AmyCoaching", "lastNameobjectStatus" : "AdvisorACTIVE"}, "strengths" : "Good test taker",} "abilityToBenefit" : true], "anticipatedStartTerm" : "FallconfidentialityLevels":null, "anticipatedStartYear" : "2012permissions":null, "studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e", "studentIntakeRequestDate" : 1331269200000, "currentAppointment" : currentProgramStatusName":"Active", {"idprogramStatusChangeReasonName" : ""null, "startDateregisteredForCurrentTerm" : 1331269200000false, "endDateactiveAlertsCount":2, : 1331269200000}, "specialServiceGroupIdsclosedAlertsCount" : 1, [{"idresidencyCounty" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"}, "DemoCounty", {"idf1Status" : "7bf36968-ad48-4c5f-9838-ebf495713c08"}"Y", "gender":"M", ... ], "referralSourceIds" :"maritalStatus":"Separated", [{"idethnicity" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"}, :null, "race":null, {"idactionPlanTaskOpenCount":1, : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"}actionPlanTaskClosedCount":4, ..."lastActionPlanCompletedDate":1440076479537, "confidentialityDisclosureAgreementSignedDate":1440076476617, ], "serviceReasonIdshomeCampus":{ : [{"id" : "d95ea029901e104b-90c14dc7-4be043f5-b547a38e-8054fc6914b7581015e204e1"}, { "idname" :"North "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"}, Campus", ... ], "programStatus" : "objectStatus":"ACTIVE" }, {"idformattedCDACompleteDate" : "acf7d7212015-196f-4353-9508-fe86c61e3c1d08-20", "nameformattedStudentIntakeCompleteDate" :null "Active"} } |
Returns
Person
Code Block |
---|
{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41", "createdDate" : 1331269200000, "createdBy" : {"id" : "91f46e39d77f4697-cea8ed36-422b4477-b215b8d0-00f6bcf5d28067c9a1d8b2db", "firstName" : "John", "lastName" : "Doe"},createdDate":1356998400000, "modifiedDatecreatedBy" :{ 1331269200000, "modifiedBy" : {"id" : "91f46e3922fc02f1-cea8d8b6-422b496c-b2158e2d-00f6bcf5d28065f6973f888e", "firstName" : "JohnDemo", "lastName" : "DoeCoach13"}, "objectStatusfullName" :"Demo "ACTIVE"Coach13" }, "firstName" : "SallymodifiedDate":1444021202117, "middleInitialmodifiedBy" : null,:{ "lastNameid" : "Student"58ba5ee3-734e-4ae9-b9c5-943774b4de41", "birthDate" : null, "primaryEmailAddressfirstName" : "sally.student@university.eduSystem", "secondaryEmailAddress" : null, "usernamelastName" : "sally.studentAdministrator", "userId" : null, "homePhonefullName" :"System Administrator"123-456-7890", "workPhone" : null}, "cellPhone" : null, "objectStatus":"ACTIVE", "addressLine1firstName" :"James", "444 West Third Street "middleName":"Jacob", "addressLine2" : null, "lastName":"Anderson", "citybirthDate" : "Dayton1986-10-24", "stateprimaryEmailAddress" : "OHdemo@trainingssp.com", "zipCodesecondaryEmailAddress" : "45402", "photoUrlusername" : null, "schoolIdjanderson218", : null, "enabledhomePhone" : false,"(555) 555-5412", "coachworkPhone" :"", {"idcellPhone" : "91f46e39-cea8-422b-b215-00f6bcf5d280", "firstNamealternatePhone" : "Amy212-555-1212", "lastNamenonLocalAddress" :false, "Advisor"}, "strengthsaddressLine1" :"321 "GoodW. testDemo takerSt.", "abilityToBenefit" : true, "addressLine2":"Apt. 214", "anticipatedStartTermcity" : "FallPhoenix", "anticipatedStartYearstate" : "2012AZ", "zipCode"studentTypeId:"55555 : "ce0d041d-d3ac-42a1-9085-7f744240e07e", "studentIntakeRequestDate", : 1331269200000, "currentAppointmentalternateAddressInUse" :false, {"idalternateAddressLine1" : "", "startDatealternateAddressLine2" : 1331269200000"", "endDatealternateAddressCity" : 1331269200000}, "specialServiceGroupIds", : [{"id"alternateAddressState":" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"}, {"idalternateAddressZipCode" : "7bf36968-ad48-4c5f-9838-ebf495713c08"}," ... ", ], "referralSourceIdsalternateAddressCountry" :"", [{"idphotoUrl" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"}:null, {"idschoolId" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"}"janderson218", ..."enabled":true, "studentIntakeCompleteDate":null, ], "serviceReasonIdsstudentType":{ : [{"id" : "d95ea0290a640a2a-90c1409d-4be01271-b5478140-8054fc6914b7d0af4a4200ef"}, { "idname" : "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"}Non-Degree Seeking", ... "objectStatus":"ACTIVE" ]}, "programStatuscoach":{ : {"id" : "acf7d72122fc02f1-196fd8b6-4353496c-95088e2d-fe86c61e3c1d65f6973f888e", "namefirstName" : "Active"} } |
Save a Person
PUT /ssp/api/1/person/{id}
Sample Post
Code Block |
---|
{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41Demo", "lastName":"Coach13", "createdDate" : 1331269200000, "createdBy" :primaryEmailAddress":"demo@trainingssp.com", {"idworkPhone" : "91f46e39-cea8-422b-b215-00f6bcf5d280"(777) 777-7777", "firstNameofficeLocation" ::null, "JohndepartmentName":null, "lastNamehomeCampusName" :"West Campus"Doe"}, "modifiedDate" : 1331269200000, "modifiedByphotoUrl" :null {"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280", }, "abilityToBenefit":true, "firstNameanticipatedStartTerm" : "John", "anticipatedStartYear":2011, "lastNameactualStartTerm" : "DoeFA2011"}, "objectStatusactualStartYear":2011, : "ACTIVEstudentIntakeRequestDate":1440076505197, "firstNamespecialServiceGroups" : "Sally", "middleInitial" : null, "lastName" : "Student:[ { "id":"856a3600-1326-11e2-9b79-406c8f22c3ce", "birthDate" : null, "primaryEmailAddress" : "sally.student@university.edu", "secondaryEmailAddressname" :"Student nullAthlete", "username" : "sally.student", "userId" : null, "homePhoneobjectStatus" : "123-456-7890",ACTIVE" "workPhone" : null, "cellPhone"}, : null, "addressLine1" : "444 West{ Third Street", "addressLine2" : null, "city" : "Dayton", "stateid" : "OH"0a640a2a-409d-1271-8140-d0c138a100fd", "zipCode" : "45402", "photoUrl" : null, "schoolIdname" :"DEI null, Focus Group"enabled", : false, "coach" : {"idobjectStatus" : "91f46e39-cea8-422b-b215-00f6bcf5d280","ACTIVE" "firstName"} : "Amy", ], "lastNamereferralSources" :[ "Advisor"}, "strengths" : "Good test taker", { "abilityToBenefit" : true, "anticipatedStartTerm" : "Fall", "anticipatedStartYear" : "2012", "studentTypeIdid" : "ce0d041d859ff107-d3ac1326-42a111e2-9085-7f744240e07e",8698-406c8f22c3ce", "studentIntakeRequestDatename" :"Student 1331269200000Conduct", "currentAppointment" : {"idobjectStatus" : "ACTIVE", "startDate"}, : 1331269200000, { "endDate" : 1331269200000}, "specialServiceGroupIds" : [{"id" : "437f6f2b858b0cab-7b1e1326-47b411e2-8603818e-9e1208605c0d406c8f22c3ce"}, {"id" : "7bf36968-ad48-4c5f-9838-ebf495713c08" "name":"HS Guidance Counselor", "objectStatus":"ACTIVE" }, ... { ], "referralSourceIds" : [{"id" : "a8c83fd4f6201a04-ee33bb31-46ee4ca5-8d89b606-9b2956696f37609f3ad09f87"}, {"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"}, ... "name":"Faculty / Staff Referral", ], "serviceReasonIdsobjectStatus" :"ACTIVE" [{"id" : "d95ea029-90c1-4be0-b547-8054fc6914b7"}, { "id" : "c9ff0ce6ccadd634-aec6bd7a-4be211e1-b1d18d28-9ca385edc6373368721922dc"}, ... ], "programStatus" :"name":"Ombudsman", {"idobjectStatus" : "acf7d721-196f-4353-9508-fe86c61e3c1d", "ACTIVE" "name" : "Active"} } |
Returns
Person
Code Block |
---|
{"id" : "58ba5ee3-734e-4ae9-b9c5-943774b4de41" ], "createdDateserviceReasons" :[ 1331269200000, "createdBy" : { "id" : "91f46e390a640a2a-cea8409d-422b1271-b2158140-00f6bcf5d280d0b3878000f6", "firstNamename" :"Scholarship Recipient"John", "lastNameobjectStatus" : "DoeACTIVE"}, "modifiedDate" : 1331269200000}, "modifiedBy" : { {"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280", "firstNameid" : "John"85709794-1326-11e2-8bab-406c8f22c3ce", "lastName" : "Doe"}, "objectStatusname" :"Academically "ACTIVEUnprepared", "firstName" : "Sally", "middleInitial" : null, "lastNameobjectStatus" : "StudentACTIVE", "birthDate" : null}, "primaryEmailAddress" : "sally.student@university.edu", "secondaryEmailAddress"{ : null, "username" : "sally.student", "userId" : null, "homePhoneid" : "123-456-7890f6201a04-bb31-4ca5-b606-609f3ad09f87", "workPhone" : null, "cellPhone" : null, "addressLine1name" : "444 West Third StreetAt-Risk Student", "addressLine2" : null, "city" : "Dayton", "stateobjectStatus" : "OHACTIVE", "zipCode" : "45402"}, "photoUrl" : null, "schoolId" :{ null, "enabled" : false, "coach" : {"id" : "91f46e39205df6c0-cea8fea0-422b11e1-b2159678-00f6bcf5d280406c8f22c3ce", "firstNamename" :"Career "AmyCoaching", "lastName" : "Advisor"}, "strengthsobjectStatus" : "Good test taker", "abilityToBenefit" : true, "anticipatedStartTerm" : "Fall", "anticipatedStartYear" : "2012", "studentTypeId" : "ce0d041d-d3ac-42a1-9085-7f744240e07e", "studentIntakeRequestDate" : 1331269200000, "currentAppointment" : {"id" : "ACTIVE" } ], "confidentialityLevels":null, "permissions":null, "currentProgramStatusName":"Active", "startDateprogramStatusChangeReasonName" : 1331269200000null, "endDateregisteredForCurrentTerm":false, : 1331269200000}, "specialServiceGroupIdsactiveAlertsCount" :2, [{"idclosedAlertsCount" : "437f6f2b-7b1e-47b4-8603-9e1208605c0d"}, :1, {"idresidencyCounty" : "7bf36968-ad48-4c5f-9838-ebf495713c08"}"DemoCounty", "f1Status":"Y", ... "gender":"M", ], "referralSourceIdsmaritalStatus" :"Separated", "ethnicity":null, [{"id" : "a8c83fd4-ee33-46ee-8d89-9b2956696f37"}race":null, "actionPlanTaskOpenCount":1, {"id" : "55aebdf7-466b-49c4-a08c-6e01eaf101d7"}actionPlanTaskClosedCount":4, "lastActionPlanCompletedDate":1440076479537, ... "confidentialityDisclosureAgreementSignedDate":1440076476617, ], "serviceReasonIds" :"homeCampus":{ [{"id" : "d95ea029901e104b-90c14dc7-4be043f5-b547a38e-8054fc6914b7581015e204e1"}, { "idname" :"North "c9ff0ce6-aec6-4be2-b1d1-9ca385edc637"}Campus", ... "objectStatus":"ACTIVE" ]}, "programStatus" : {"idformattedCDACompleteDate" : "acf7d7212015-196f-4353-9508-fe86c61e3c1d08-20", "nameformattedStudentIntakeCompleteDate" : "Active"} }:n |
Delete a Person
DELETE /ssp/api/1/person/{id}
Security
PERSON_DELETE
Returns
Code Block |
---|
{"success" : "true"} |
...
GET /ssp/api/1/person/{id}/history/print
Security
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
PDF Report - To be completed by Unicon