> For the complete documentation index, see [llms.txt](https://guide.fariaedu.com/integrations-portal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.fariaedu.com/integrations-portal/openapply/public-rest-apis/v3/school-years.md).

# School Years

This page describes all the APIs relating to school years (academic years).

## Get all School Years

> Retrieves a list of all school years. Results are paginated.\
> Use the \`page\` and \`per\_page\` query parameters to control pagination.<br>

```json
{"openapi":"3.0.1","info":{"title":"openapply","version":"3.0.0"},"tags":[{"name":"School Years","description":"This page describes all the APIs relating to school years (academic years)."}],"servers":[{"url":"https://api.openapply.com","description":"CAN region auth server"},{"url":"https://api.openapply.cn","description":"CN region auth server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/api/v3/school_years":{"get":{"summary":"Get all School Years","tags":["School Years"],"parameters":[{"name":"page","in":"query","required":false,"description":"The page number of results to return.","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","required":false,"description":"Request for how many records to return.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"count","in":"query","required":false,"description":"Synonym for per_page","schema":{"type":"integer"}}],"description":"Retrieves a list of all school years. Results are paginated.\nUse the `page` and `per_page` query parameters to control pagination.\n","responses":{"200":{"description":"school years found","content":{"application/json":{}}}}}}}}
```

## Get a School Year

> Fetch an instance of a school year<br>

```json
{"openapi":"3.0.1","info":{"title":"openapply","version":"3.0.0"},"tags":[{"name":"School Years","description":"This page describes all the APIs relating to school years (academic years)."}],"servers":[{"url":"https://api.openapply.com","description":"CAN region auth server"},{"url":"https://api.openapply.cn","description":"CN region auth server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/api/v3/school_years/{id}":{"get":{"summary":"Get a School Year","tags":["School Years"],"parameters":[{"name":"id","in":"path","required":true,"description":"Serial database ID that uniquely identifies a school year record in OpenApply","schema":{"type":"integer"}}],"description":"Fetch an instance of a school year\n","responses":{"200":{"description":"school year found","content":{"application/json":{}}},"404":{"description":"school year not found","content":{"application/json":{}}}}}}}}
```