# Festival API

## API Docs
- Health [Health check](https://184265hspu.apidog.io/health-check-40056742e0.md): Unauthenticated endpoint that returns a simple OK payload.
- Festivals [List festivals](https://184265hspu.apidog.io/list-festivals-40056743e0.md): Search and filter festivals. Returns paginated results with query, country, category, genre, deadline range, fee max, submission platform, and submission platform filters.
- Festivals [Get festival detail](https://184265hspu.apidog.io/get-festival-detail-40056744e0.md): Returns a full festival record including deadlines, fees, acceptance rate, past winners, programming directors, and composite score.
- Festivals [Get top scored festivals](https://184265hspu.apidog.io/get-top-scored-festivals-40056745e0.md): Returns festivals ranked by composite score. Supports page/per_page pagination (default: 20 results, max: 100).
- Rosters [Get festival roster](https://184265hspu.apidog.io/get-festival-roster-40056746e0.md): Returns the programming roster (films screened) for a festival.
- Categories [List categories](https://184265hspu.apidog.io/list-categories-40056747e0.md): Returns all festival categories with the count of active festivals in each.
- Countries [List available countries](https://184265hspu.apidog.io/list-available-countries-40056748e0.md): Returns all countries with festival counts, ordered by count descending.

## Schemas
- [HealthResponse](https://184265hspu.apidog.io/healthresponse-16453482d0.md): 
- [FestivalListEntry](https://184265hspu.apidog.io/festivallistentry-16453483d0.md): 
- [FestivalListResponse](https://184265hspu.apidog.io/festivallistresponse-16453484d0.md): 
- [FestivalDetail](https://184265hspu.apidog.io/festivaldetail-16453485d0.md): 
- [FestivalRosterResponse](https://184265hspu.apidog.io/festivalrosterresponse-16453486d0.md): 
- [CategoryListResponse](https://184265hspu.apidog.io/categorylistresponse-16453487d0.md): 
- [CountryListResponse](https://184265hspu.apidog.io/countrylistresponse-16453488d0.md): 
- [CountryItem](https://184265hspu.apidog.io/countryitem-16453489d0.md): 
- [ErrorResponse](https://184265hspu.apidog.io/errorresponse-16453490d0.md):