What's live, what's still being built, and what's deliberately out of scope for the /src mirror. This reflects the actual state of the API, and will update in parallel with the changelog.
| Resource | Status | Notes |
|---|---|---|
/src/categories | Live | Single-record lookup |
/src/games | Live | Single-record + filterable, sortable list |
/src/gametypes | Live | Single-record + list |
/src/levels | Live | Single-record lookup |
/src/platforms | Live | Single-record + list |
/src/regions | Live | Single-record + list |
/src/runs | Live | Single-record + filterable, sortable list |
/src/series | Live | Single-record + list |
/src/users | Live | Single-record + repaired list* |
/src/variables | Live | Single-record lookup |
/src/guests | Removed | Not planned |
/src/profiles | Removed | Not planned |
/src/developers | Deprecated | Planned for /v1 |
/src/engines | Deprecated | Planned for /v1 |
/src/genres | Deprecated | Planned for /v1 |
/src/publishers | Deprecated | Planned for /v1 |
The user list is a new addition, fully rebuilt from the speedrun.io index layer, true to the original API specification.
relational results related to a primary resource id:
| Endpoint | Status |
|---|---|
/src/categories/{id}/variables | In progress |
/src/games/{id}/categories | In progress |
/src/games/{id}/levels | In progress |
/src/games/{id}/variables | In progress |
/src/leaderboards/{id}/category/{category_id} | Live |
/src/leaderboards/{id}/level/{level_id}/{category_id} | Live |
/src/levels/{id}/categories | In progress |
/src/levels/{id}/variables | In progress |
/src/series/{id}/games | In progress |
/src/users/{id}/personal-bests | In progress |
/src/categories/{id}/records | Not planned |
/src/games/{id}/derived-games | Not planned |
/src/games/{id}/records | Not planned |
/src/levels/{id}/records | Not planned |
Endpoints marked in progress return 501 with a message indicating they're planned but not yet live — not a 403, which means the path doesn't exist at all.
Notable filter parameters and specialty matching methods:
| Endpoint | Status |
|---|---|
/src/games/{abbreviation} | Live |
/src/games?name={fuzzy} | In progress |
/src/games?released={year} | In progress |
/src/leaderboards/...?top={N} | Live |
/src/leaderboards/...?{filter}= | Planned for /v1 |
/src/runs?guest={name} | Planned for /v1 |
/src/runs?orderby=submitted | Live |
/src/runs?orderby=verify-date | Live |
/src/runs?orderby={other} | Planned for /v1 |
/src/users?name={fuzzy} | In progress |
/src/users?twitch={handle} | In progress |
/src/users?twitter={handle} | In progress |
/src/users?speedrunslive={handle} | In progress |
Leaderboard filtering other than top places is postponed until the /v1 release and will be addressed in an upcoming news release. Run sorting other than submitted and verify-date is removed from the /src spec for performance reasons, while all filter options have been kept.
Options for embedding support:
| Endpoint | Status |
|---|---|
?embed=categories | In progress |
?embed=games | In progress |
?embed=gametypes | In progress |
?embed=levels | In progress |
?embed=platforms | In progress |
?embed=regions | In progress |
?embed=runs | In progress |
?embed=variables | In progress |
?embed=players | In progress |
?embed=moderators | In progress |
Embedding support for /src will entail a bandwdith-limited paradigm where expected result size will be precomputed, with overflows resulting in a413 content too large error.