API

The KittyPaper API allows developers to query the available versions.

Get All Available Versions

GET /api/versions

Returns a JSON array of all available versions.

Example Response

[{"build_number":"16","mc_version":"1.21.10","commit_hash":"8fc2b8958de4b2a5a5fe1b2f16e54c9f8cdddb08","server_file_hash":"52dff07527ff3956494ccd570827ff798972dd79e6162e2ca33b746ce6821399","commits":[{"hash":"8fc2b8958de4b2a5a5fe1b2f16e54c9f8cdddb08","author":"Lilly Schramm","date":"2025-12-05T21:38:44+01:00","message":"chore: Update PaperRef"}]}]

Get Latest Available Version

GET /api/versions/latest

Returns a JSON object of the latest available version.

Example Response

{"build_number":"16","mc_version":"1.21.10","commit_hash":"8fc2b8958de4b2a5a5fe1b2f16e54c9f8cdddb08","server_file_hash":"52dff07527ff3956494ccd570827ff798972dd79e6162e2ca33b746ce6821399","commits":[{"hash":"8fc2b8958de4b2a5a5fe1b2f16e54c9f8cdddb08","author":"Lilly Schramm","date":"2025-12-05T21:38:44+01:00","message":"chore: Update PaperRef"}]}

Download Server Jar

GET /api/download?id={build_number}

Downloads the server jar file for the specified build number.

Query Parameters

• id (required): The build number of the version to download.

Rate Limiting

To prevent abuse, the download endpoint is rate-limited. Each IP address is allowed a maximum of 10 downloads every 10 minutes. If the limit is exceeded, a 429 Too Many Requests response will be returned.