Search Future Students
POST/students/future/search
Search Future Students using a variety of filters.
Request
- application/json
Body
required
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
- application/json
- Schema
- Example (from schema)
- Successful
Schema
- Array [
- ]
Status Code
meta objectrequired
Meta options for search responses
Possible values: >= 1
Default value: 1
page number starts with 1
Possible values: >= 1
and <= 100
Default value: 10
No of items per page
number of records in the result set
Possible values: >= 1
Default value: 1
page number starts with 1
Possible values: >= 1
and <= 100
Default value: 100
No of records to limit per page
Possible values: <= 100
number of records in the current page
number of pages in the result set
Default value: surname,givenName,schoolId
sort by field(s)
Default value: ASC
sort direction
range object
Possible values: >= 1
Default value: 1
start range
Default value: 100
end range
data object[]
titleObj objectnullablerequired
{
"code": "OK",
"meta": {
"page": 1,
"limit": 10,
"traceContext": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"totalRecordCount": 1,
"pageNum": 1,
"pageLimit": 100,
"pageRecordCount": 1,
"pageNumTotal": 1,
"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-03-12T03:31:59.615Z",
"created": "2025-03-12T03:31:59.615Z",
"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-03-12",
"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-03-12",
"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-03-12T03:31:59.616Z",
"enrolForDateDMY": "string",
"applicationPriority": "string",
"applicationPriorityCode": "string",
"applicationStatusId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationStatusCode": "string",
"applicationStatus": "string",
"applicationStatusSortOrder": 0,
"enrolmentPeriod": "string",
"enrolmentPeriodCode": "string",
"originalEnquiryDate": "2025-03-12T03:31:59.616Z",
"originalApplicationDate": "2025-03-12T03:31:59.616Z",
"defaultApplicationDate": "2025-03-12T03:31:59.616Z"
}
]
}
{
"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": {
"traceContext": "7f5db7a2-547e-4f98-9bd0-8aee68a03ef4",
"totalRecordCount": 1,
"pageNum": "All",
"pageLimit": "All",
"pageRecordCount": "All",
"pageNumTotal": "All",
"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
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1100",
"message": "Bad Request"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1101",
"message": "Unauthorized"
}
]
}
Forbidden
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
errors object[]required
{
"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
{
"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
{
"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
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
{
"errors": [
{
"code": "PA1109",
"message": "Internal Server Error"
}
]
}