Get top scored festivals

GET

https://festivalapi.com/v1/festivals/scored/

Returns festivals ranked by composite score. Supports page/per_page pagination (default: 20 results, max: 100).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Festival ranking.

Bodyapplication/json

🟠401

🟠402

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://festivalapi.com/v1/festivals/scored/?page=&per_page=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "count": 85,
    "results": [
        {
            "id": 42,
            "name": "Sundance Film Festival",
            "year": 2026,
            "country": "United States",
            "city": "Park City",
            "state": "UT",
            "categories": [
                "Feature",
                "Short Film",
                "Documentary"
            ],
            "genres": [
                "Drama",
                "Comedy",
                "Experimental"
            ],
            "deadline_regular": "2025-09-15",
            "deadline_late": "2025-10-15",
            "event_start_date": "2026-01-22",
            "event_dates": "January 22 – February 1, 2026",
            "regular_fee": 85,
            "submission_platforms": [
                "FilmFreeway"
            ],
            "composite_score": 94.5
        }
    ]
}

Modified at 2026-07-14 22:16:25

Get festival detail

Get festival roster