---
title: "Get Annales Filters"
method: GET
path: "/annales-exercises/filters"
tags: ["Annales Exercises"]
---

# Get Annales Filters

`GET /annales-exercises/filters`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/annales-exercises/filters`
- Auth: OAuth 2 (password, token URL `api/login`)

Get distinct filter values for dropdowns, optionally scoped.

## Query parameters

- `school_level` string, nullable: If set, scope returned years/sessions/topics/difficulties to annales for this school level. school_levels itself is always returned across the whole collection.
- `exam_type` string, nullable: If set ('bac' | 'brevet' | 'olympiades'), scope returned years/sessions/topics/difficulties to that exam bank.
- `year` integer, nullable: If set, scope returned sessions/topics to that year.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)