Search Future Students
POST/students/future/search
Search Future Students using a variety of filters.
Request
- application/json
Body
required
enrolForYear string
applicationStatus string
applicationPriority string
applicationCampus uuid[]
applicationYearLevel uuid[]
schoolId string
surname string
gender string
studentTypeCodeIn uuid[]
studentTypeSystemMeaningIn uuid[]
fullTimeStatus string
nationality string
homeLanguage string
given string
givenMode string
studentActivityType string
studentActivityStatus string
activityByStaffId uuid
followUp boolean
followUpDate date-time
followUpStaffId uuid
pageLimit int32
pageNum int32
simpleSearchValue string
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
- application/json
- Schema
- Example (from schema)
- Successful
Schema
- Array [
- ]
code stringrequired
Status Code
meta objectrequired
Meta options for search responses
page numberrequired
Possible values: >= 1
Default value: 1
page number starts with 1
limit numberrequired
Possible values: >= 1
and <= 100
Default value: 10
No of items per page
totalRecordCount numberrequired
number of records in the result set
pageRecordCount numberrequired
Possible values: <= 100
number of records in the current page
pageNumTotal numberrequired
number of pages in the result set
traceContext uuidrequired
pageSortBy stringrequired
Default value: surname,givenName,schoolId
sort by field(s)
pageSortDir stringrequired
Default value: ASC
sort direction
range objectrequired
start number
Possible values: >= 1
Default value: 1
start range
end number
Default value: 100
end range
data object[]
communityId uuidrequired
givenName stringrequired
preferredName stringnullablerequired
otherGivenName stringnullablerequired
surname stringnullablerequired
nameSuffix stringnullablerequired
schoolId stringrequired
recordType stringrequired
companyName stringnullablerequired
modified date-timenullablerequired
created date-timerequired
displayName stringrequired
displayNameList stringrequired
spouseCommunityId uuidnullablerequired
initials stringrequired
email stringnullablerequired
mobile stringnullablerequired
phone stringnullablerequired
studentType stringnullablerequired
studentTypeCode stringnullablerequired
genderId uuidnullablerequired
gender stringnullablerequired
genderCode stringnullablerequired
genderSortOrder integernullablerequired
genderSystemMeaning stringnullablerequired
titleObj objectnullablerequired
id uuidrequired
description stringrequired
title stringnullablerequired
addressId uuidnullablerequired
internalNameFormat stringrequired
internalName stringrequired
externalName stringrequired
mailNameFormat stringrequired
salutationFormat stringrequired
addressFull stringnullablerequired
addressComma stringnullablerequired
postalAddressFull stringnullablerequired
postalAddressComma stringnullablerequired
homeAddress1 stringnullablerequired
homeAddress2 stringnullablerequired
homeAddress3 stringnullablerequired
homeSuburb stringnullablerequired
homePostCode stringnullablerequired
homeCountry stringnullablerequired
homeState stringnullablerequired
postalAddress1 stringnullablerequired
postalAddress2 stringnullablerequired
postalAddress3 stringnullablerequired
postalSuburb stringnullablerequired
postalPostCode stringnullablerequired
postalCountry stringnullablerequired
postalState stringnullablerequired
defaultSMS stringnullablerequired
preferredPhone stringnullablerequired
birthDate datenullablerequired
constituenciesCsv stringrequired
entityTypes string[]required
photoId uuidnullablerequired
sortName stringrequired
headOfCampus stringnullablerequired
headOfHouse stringnullablerequired
subSchoolCode stringnullablerequired
subSchoolDescription stringnullablerequired
yearLevelCoOrdinator stringnullablerequired
formGroup stringnullablerequired
formGroupCode stringnullablerequired
formGroupTeacher stringnullablerequired
rollGroup stringnullablerequired
rollGroupCode stringnullablerequired
rollGroupTeacher stringnullablerequired
tutorGroup stringnullablerequired
tutorGroupCode stringnullablerequired
tutorGroupTeacher stringnullablerequired
homeGroup stringnullablerequired
homeGroupCode stringnullablerequired
homeGroupTeacher stringnullablerequired
studentFTE numbernullablerequired
learningPathwayCode stringnullablerequired
learningPathwayDescription stringnullablerequired
governmentStudentNumber stringnullablerequired
academicStartDate daterequired
applicationCampusId uuidnullablerequired
applicationCampus stringnullablerequired
applicationCampusCode stringnullablerequired
applicationCampusSortOrder integernullablerequired
applicationYearLevelId uuidnullablerequired
applicationYearLevel stringnullablerequired
applicationYearLevelCode stringnullablerequired
applicationYearLevelSortOrder integernullablerequired
applicationHouseCode stringnullablerequired
applicationHouse stringnullablerequired
enrolForYear integerrequired
enrolForDate date-timerequired
enrolForDateDMY stringrequired
applicationPriority stringnullablerequired
applicationPriorityCode stringnullablerequired
applicationStatusId uuidnullablerequired
applicationStatusCode stringnullablerequired
applicationStatus stringnullablerequired
applicationStatusSortOrder integernullablerequired
enrolmentPeriod stringnullablerequired
enrolmentPeriodCode stringnullablerequired
originalEnquiryDate date-timenullablerequired
originalApplicationDate date-timerequired
defaultApplicationDate date-timerequired
{
"code": "OK",
"meta": {
"page": 1,
"limit": 10,
"totalRecordCount": 1,
"pageRecordCount": 1,
"pageNumTotal": 1,
"traceContext": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"pageSortBy": "surname,givenName,schoolId",
"pageSortDir": "ASC",
"range": {
"start": 1,
"end": 1
}
},
"data": [
{
"communityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"givenName": "string",
"preferredName": "string",
"otherGivenName": "string",
"surname": "string",
"nameSuffix": "string",
"schoolId": "string",
"recordType": "string",
"companyName": "string",
"modified": "2025-06-10T01:29:31.133Z",
"created": "2025-06-10T01:29:31.133Z",
"displayName": "string",
"displayNameList": "string",
"spouseCommunityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"initials": "string",
"email": "string",
"mobile": "string",
"phone": "string",
"studentType": "string",
"studentTypeCode": "string",
"genderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"gender": "string",
"genderCode": "string",
"genderSortOrder": 0,
"genderSystemMeaning": "string",
"titleObj": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"description": "string"
},
"title": "string",
"addressId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"internalNameFormat": "string",
"internalName": "string",
"externalName": "string",
"mailNameFormat": "string",
"salutationFormat": "string",
"addressFull": "string",
"addressComma": "string",
"postalAddressFull": "string",
"postalAddressComma": "string",
"homeAddress1": "string",
"homeAddress2": "string",
"homeAddress3": "string",
"homeSuburb": "string",
"homePostCode": "string",
"homeCountry": "string",
"homeState": "string",
"postalAddress1": "string",
"postalAddress2": "string",
"postalAddress3": "string",
"postalSuburb": "string",
"postalPostCode": "string",
"postalCountry": "string",
"postalState": "string",
"defaultSMS": "string",
"preferredPhone": "string",
"birthDate": "2025-06-10",
"constituenciesCsv": "string",
"entityTypes": [
"string"
],
"photoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"sortName": "string",
"headOfCampus": "string",
"headOfHouse": "string",
"subSchoolCode": "string",
"subSchoolDescription": "string",
"yearLevelCoOrdinator": "string",
"formGroup": "string",
"formGroupCode": "string",
"formGroupTeacher": "string",
"rollGroup": "string",
"rollGroupCode": "string",
"rollGroupTeacher": "string",
"tutorGroup": "string",
"tutorGroupCode": "string",
"tutorGroupTeacher": "string",
"homeGroup": "string",
"homeGroupCode": "string",
"homeGroupTeacher": "string",
"studentFTE": 0,
"learningPathwayCode": "string",
"learningPathwayDescription": "string",
"governmentStudentNumber": "string",
"academicStartDate": "2025-06-10",
"applicationCampusId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationCampus": "string",
"applicationCampusCode": "string",
"applicationCampusSortOrder": 0,
"applicationYearLevelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationYearLevel": "string",
"applicationYearLevelCode": "string",
"applicationYearLevelSortOrder": 0,
"applicationHouseCode": "string",
"applicationHouse": "string",
"enrolForYear": 0,
"enrolForDate": "2025-06-10T01:29:31.134Z",
"enrolForDateDMY": "string",
"applicationPriority": "string",
"applicationPriorityCode": "string",
"applicationStatusId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationStatusCode": "string",
"applicationStatus": "string",
"applicationStatusSortOrder": 0,
"enrolmentPeriod": "string",
"enrolmentPeriodCode": "string",
"originalEnquiryDate": "2025-06-10T01:29:31.134Z",
"originalApplicationDate": "2025-06-10T01:29:31.134Z",
"defaultApplicationDate": "2025-06-10T01:29:31.134Z"
}
]
}
{
"code": "OK",
"data": [
{
"communityId": "6806daf7-dd36-4522-8190-a66de03cea82",
"givenName": "Fozzie",
"preferredName": "Fozzie",
"otherGivenName": null,
"surname": "Bear",
"nameSuffix": null,
"schoolId": "39",
"recordType": "Person",
"companyName": null,
"sortName": "Bear Fozzie",
"modified": "2022-08-30T05:32:01.884Z",
"created": "2022-05-17T23:12:28.762Z",
"displayName": "Fozzie Bear",
"displayNameList": "Bear, Fozzie",
"spouseCommunityId": null,
"initials": "FB",
"email": null,
"mobile": null,
"phone": null,
"studentType": null,
"studentTypeCode": null,
"genderId": null,
"gender": null,
"genderCode": null,
"genderSortOrder": null,
"genderSystemMeaning": null,
"titleObj": null,
"title": null,
"addressId": "2f2de3c0-b6d8-4d50-9df6-76c395eeb4c6",
"internalNameFormat": "Bear, Fozzie",
"internalName": "Bear, Fozzie",
"externalName": "Fozzie Bear",
"mailNameFormat": "F Bear",
"salutationFormat": "Bear",
"addressFull": "",
"addressComma": "",
"postalAddressFull": "",
"postalAddressComma": "",
"homeAddress1": null,
"homeAddress2": null,
"homeAddress3": null,
"homeSuburb": null,
"homePostCode": null,
"homeCountry": "Australia",
"homeState": null,
"postalAddress1": null,
"postalAddress2": null,
"postalAddress3": null,
"postalSuburb": null,
"postalPostCode": null,
"postalCountry": "Australia",
"postalState": null,
"defaultSMS": null,
"preferredPhone": null,
"birthDate": "2022-05-18",
"constituenciesCsv": "@SF",
"entityTypes": [
"community",
"futureStudent"
],
"photoId": "33c8a07c-1993-426f-ba8f-8798a0e0548e",
"totalRecordCount": 1,
"applicationCampusId": "a9c3b4a6-fef7-417f-bea5-e3dab946d49e",
"applicationCampus": "Queensland",
"applicationCampusCode": "QLD",
"applicationCampusSortOrder": 0,
"applicationYearLevelId": "4643935c-fa56-4e8b-951d-a388ebf7cb55",
"applicationYearLevel": "Year 9",
"applicationYearLevelCode": "09",
"applicationYearLevelSortOrder": 0,
"applicationHouseCode": null,
"applicationHouse": null,
"enrolForYear": 2023,
"enrolForDate": "2023-06-01T04:27:35.043Z",
"enrolForDateDMY": "01/06/2023",
"applicationPriority": null,
"applicationPriorityCode": null,
"applicationStatusId": "aea5dfab-7051-42e3-807e-236929facb3a",
"applicationStatusCode": "A",
"applicationStatus": "Application made",
"applicationStatusSortOrder": 1,
"enrolmentPeriod": "Semester 1",
"enrolmentPeriodCode": "S1",
"headOfCampus": null,
"subSchoolCode": null,
"subSchoolDescription": null,
"yearLevelCoordinator": null,
"headOfHouse": null,
"formGroupCode": null,
"formGroup": null,
"formGroupTeacher": null,
"rollGroupTeacher": null,
"tutorGroupTeacher": null,
"homeGroupTeacher": null,
"learningPathwayCode": null,
"learningPathwayDescription": null,
"studentFTE": null,
"tutorGroupCode": null,
"tutorGroup": null,
"rollGroupCode": null,
"rollGroup": null,
"homeGroupCode": null,
"homeGroup": null,
"startDate": null,
"governmentStudentNumber": null,
"originalEnquiryDate": null,
"originalApplicationDate": "2022-05-17T23:11:11.970Z",
"defaultApplicationDate": "2022-05-17T23:11:11.970Z"
}
],
"meta": {
"page": 1,
"limit": 100,
"totalRecordCount": 1,
"pageRecordCount": 1,
"pageNumTotal": 1,
"traceContext": "7f5db7a2-547e-4f98-9bd0-8aee68a03ef4",
"pageSortBy": "surname,givenName,schoolId",
"pageSortDir": "ASC",
"range": {
"start": 1,
"end": 1
}
}
}
Bad Request
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
code stringrequired
message stringrequired
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1100",
"message": "Bad Request"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
code stringrequired
message stringrequired
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1101",
"message": "Unauthorized"
}
]
}
Forbidden
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
code stringrequired
message stringrequired
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1102",
"message": "Forbidden"
}
]
}
Resource not found
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
code stringrequired
message stringrequired
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1103",
"message": "Not Found"
}
]
}
Unprocessable entity
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
code stringrequired
message stringrequired
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1108",
"message": "Unprocessable Entity"
}
]
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
code stringrequired
message stringrequired
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1109",
"message": "Internal Server Error"
}
]
}
Loading...