The Identify Student service provides a means to perform a search against the full set of students contained within the PASI Core. Given a set of search criteria, PASI will perform a search and return a subset of information for the matching students.

The service can be accessed by systems with the PASI Client System Role.

K-12 Organization Client

The Identify Student Request contains the set of information that PASI will use as search criteria. The following information can be used to perform the search.

• Caller Reason Code
• Include All Quality Levels
• Include Student With Disclosure Restriction
• Student Locator
  • State Province Id
  • Extended Student Criteria
  • Age Criteria
    • Approximate Age
    • Birth Date
    • Grade Level
  • Name Criteria
    • First Name
    • Last Name
    • Middle Name
    • Suffix Name
  • Address Criteria
    • Student Address Street
    • Student Address City
    • Student Address Province
    • Student Address Postal Code
    • Student Address Country

Additional Notes:

• The search based on student name will require both a ‘First Name’ and a ‘Last Name’. The ‘First Name’ can be as little as an initial, however the ‘Last Name’ must be provided in full.
• The student name provided will be compared against all known student names within PASI Core.
• Student Approximate Age - This can be used instead of the student birth date if it is unknown or is unreliable.
• Student Grade - If neither the Student Birth Date nor Approximate Age have been provided, the Grade Code will be used to estimate a student’s age.
• Secondary ASN in Results - If a Secondary ASN is added to the results because it matches the search criteria then PASI will ensure that the Primary ASN is added as well. The Primary ASN could be still be filtered out based on the other “Include” flags.

In order to use this service, the PASI Client must:

1. Ensure that the use of the service within their product is consistent with the Reason provided as part of the Identify Student Request.
2. Ensure that a request using the ‘Include All Quality Levels’ or the ‘Include Students with Disclosure Restrictions’ option is not the default behavior of the system. These options must only be used as a subsequent request when the student being search for was not contained within the search results.
3. Ensure that before this service is called using the ‘Include All Quality Levels’ option, that the end user of the product is aware that their actions will be recorded for auditing purposes.
4. Ensure that before this service is called using the ‘Include Students with Disclosure Restrictions’ option, that the end user of the product is aware that the information they are about to request is considered sensitive and that their actions will be recorded for auditing purposes. The PASI Team will be providing detailed requirements related to the use of the ‘Include Students with Disclosure Restrictions’ option, outlining user interface requirements and functionality that must be established within the PASI Client system.

There are no validation rules applied by this service.

The Identify Student service uses a PASI search algorithm which performs searches on several types of matches such as exact match, phonetic match, partial name match and alternate name match. Further details on the search operation can be found PASI DevNet Identify Student Technical Details.

The information provided as part of the request will be used by PASI to search for the student. The search results returned by PASI will fit into one of three quality levels:

By default, PASI will only return results from the highest quality level found. This means that if any High Quality matches were found, Medium Quality and Low Quality matches would not be returned. If no High Quality matches were found, then only Medium Quality matches would be returned. And if no High or Medium Quality matches were found, then the Low Quality matches would be returned.

By default, only student records with valid ASNs will be returned. This can be changed by using the Quality Level Filter outlined below.

Note: For 2018 and older end points, the Student School Enrolment information will be updated using the following mapping and then returned as part of the Response Information:

• Set Registration Status:

When search results are returned, each record returned will include a Search Rank, indicating how well the returned student matches against the search criteria. PASI will use a variety of matching techniques to calculate this rank.

Other techniques specific to a particular search criteria may also be used, with the ultimate goal of finding the right student.

Based on the student search ranking, PASI will return the students that have the highest matching score, however some constraints have been added to the Identify Student service to ensure that the privacy of other students is protected

By default, search results will not include students whose information should not be disclosed as per the typical disclosure rules, and the Match Status will return a status of Student With Disclosure Restriction. As a subsequent request, a software product can request that a search be repeated with these students included in the results. Making this call requires that the software product ensures that the end user is aware that the information they are about to request is deemed sensitive and that access to this information is being audited.

A maximum of 20 students will be returned. This means that if the search results in more than 20 students that are equally scored, then no search results will be provided with the expectation that the search criteria needs to be refined (see the Insufficient match student status below).

If the student being sought is not included in the best quality level (High or Medium) a subsequent call can be made with the option to ‘Include All Quality Levels’. This returns the best matches across all quality levels based on the matching score.

When this option is used, the student records contained in the High Quality level will generally remain at the top of the list (as their score will be better than matches in the Medium and Low Quality Levels). However, because the Quality level is based solely on Student Name and Student Age search criteria, it is possible (based on the additional search criteria) that a Medium Quality match could score higher than a High Quality match, and a Low Quality match could score higher than a Medium Quality match.

In addition, Deactivated ASNs are normally excluded from the search results, however, when using this option, they will be included.

For a student to be returned by Identify Student for a Limited Access School/Authority, the student must have one of the following:

• Association to the school/authority By Student Creation, By Current School Enrolment, or By Last School Enrolment, OR
• Restriction Level on the Limited Access School/Authority is Low, AND the student Has a Historical School Enrolment with the school/authority

The following Student Address restriction applies:

• 2019 Endpoint and onwards: No Restriction. Both student's Mailing and Physical addresses are included as part of search criteria.
• 2018 Endpoint and prior: Student Physical addresses are excluded. Only the Student mailing address are considered as part of search criteria.

Contains limited information about the students found during the search. This information includes: legal name(s), aliases, partial address(es), birth date, and some enrolment information. This information will be organized into the different quality levels as described in the detailed section on PASI DevNet Identify Student Technical Details.

The following information is returned after a successful request has been processed:

• Search Match Status
• A list of students that had High Quality Matches
• A list of students that had Medium Quality Matches
• A list of students that had Low Quality Matches

On the 2018 end point, the following information about each matched Student that is returned by the search:

• Search Rank
• Alberta Student Number
• Primary Alberta Student Number
• Secondary Alberta Student Number
• Is Deactivated
• Is Deceased
• Has Disclosure Restrictions
• Student Identity
  • Birth Date
  • Student Identity Source Document Issued Date
  • Document Number
  • Document Reference ID (this will always be null)
  • Document Type
  • Is Name Exact
  • Ref ID
• Student Names - A list of Student Name records.
• Student Address Summary
  • Address Type (Student Address) ¹⁾
  • City
  • Postal Code
• Student School Enrolment Summary
  • Grade (Student School Enrolment)
  • Registration Start Date
  • Registration Exit Date
  • Registration Status
  • School Year (Student School Enrolment)

On the 2019 end point and later, the following information about each matched Student that is returned by the search:

• Search Rank
• Alberta Student Number
• Primary Alberta Student Number
• Secondary Alberta Student Number
• Is Deactivated
• Is Deceased
• Has Disclosure Restrictions
• Birth Date
• Student Names - a list of Student Name records.
• Current Identity Name
• Student Address Summary
  • Address Type (Student Address) ²⁾
  • City
  • Postal Code
• Student School Enrolment Summary
  • Grade (Student School Enrolment)
  • Registration Start Date
  • Registration Exit Date
  • School Year (Student School Enrolment)

* School Enrolments returned are limited to enrolments in Future School Years, the Current School Year, and the last 2 calendar years. All Enrolments for Future and Current school years will be included. Only the 2 most recent enrolments from the last 2 calendar years will be included.

The search results includes a status. The status may be one of the following: