Add parameter for academic year to GET Admissions Candidates endpoint

This is related to endpoint

https://api.sky.blackbaud.com/school/v1/admissions/candidates

Currently it does not accept any parameters and uses the Current Admissions Year in the app. We really need to be able to pull candidates lists for different academic years and we can't be editing the current year multiple times to make different calls.

My suggestion is to add a parameter for the acsdemic year, using the ID which can be read via the https://api.sky.blackbaud.com/school/v1/years endpoint. If the parameter is empty it returns the currently selected one in the app which would not break any existing functionality and make it compatible with existing code, while also giving ability to look into future years and even prior years.


If there is concern about breaking existing code than a new endpoint could be created.

  • Yves Parent
  • Oct 21 2021
  • Shipped
  • Attach files
  • Admin
    Stephen Boyle commented
    September 27, 2022 14:53

    This endpoint now has a school year parameter. Go try it out here.