Documentation

MC Versions API Documentation

Get Java Versions

Retrieves available Minecraft Java Edition versions.

  • Method: GET
  • URL: https://mc-versions-api.net/api/java
  • Parameters:
    • detailed (optional bool): Specifies whether detailed information should be included
    • order (optional string): Specifies the order of the results by date. Possible values are asc and desc

Example

Example request

javascript
// Example API call to retrieve Minecraft Java Edition versions fetch("https://mc-versions-api.net/api/java") .then((response) => response.json()) .then((data) => { // Handle the response data console.log(data); }) .catch((e) => { // Handle errors console.error("An error occurred:", e.error); });

Example response

json
{ "result": [ "1.20.1", "1.20", "1.19.4", "1.19.3", "1.19.2", "1.19.1", "1.19", "..." ] }
(The "..." is not part of the response, it's just to show that there are more results)

Get Forge Versions

Retrieves available Forge versions.

  • Method: GET
  • URL: https://mc-versions-api.net/api/forge
  • Parameters:
    • detailed (optional bool): Specifies whether detailed information should be included
    • version (optional string): Filters versions by a specific text
    • order (optional string): Specifies the order of the results by date. Possible values are asc and desc

Example

Example request

javascript
// Example API call to retrieve Forge versions for 1.20.1 fetch("https://mv-versions-api/api/forge?version=1.20.1") .then((response) => response.json()) .then((data) => { // Handle the response data console.log(data); }) .catch((e) => { // Handle errors console.error("An error occurred:", e.error); });

Example response

json
{ "result":["47.1.0", "47.0.50", "47.0.49", "47.0.46", "..."] }
(The "..." is not part of the response, it's just to show that there are more results)

Java Auto-Completion

Performs auto-completion for Java Edition versions.

  • Method: GET
  • URL: https://mc-versions-api.net/api/autocomplete/java
  • Parameters:
    • detailed (optional bool): Specifies whether detailed information should be included
    • order (optional string): Specifies the order of the results by date. Possible values are asc and desc
    • limit (optional int): Limits the number of returned results (Default is 3)
    • text (required string): Text used for searching a version

Example

Example request

javascript
// Example API call to retrieve autocomplete data for Minecraft Java Edition versions fetch("https://mv-versions-api/api/autocomplete/java?limit=3&text=1.2") .then((response) => response.json()) .then((data) => { // Handle the response data console.log(data); }) .catch((e) => { // Handle errors console.error("An error occurred:", e.error); });

Example response

json
{ "result": ["1.20.1", "1.20", "1.11.2"] }

Forge Auto-Completion

Performs auto-completion for Forge versions.

  • Method: GET
  • URL: https://mc-versions-api.net/api/autocomplete/forge
  • Parameters:
    • detailed (optional bool): Specifies whether detailed information should be included
    • version (optional string): Filters versions by a specific text
    • order (optional string): Specifies the order of the results by date. Possible values are asc and desc
    • limit (optional int): Limits the number of returned results (Default is 3)
    • text (required string): Text used for searching a version

Example

Example request

javascript
// Example API call to retrieve autocomplete data for Forge versions fetch("https://mv-versions-api/api/autocomplete/forge?version=1.20.1&limit=3&text=47.") .then((response) => response.json()) .then((data) => { // Handle the response data console.log(data); }) .catch((e) => { // Handle errors console.error("An error occurred:", e.error); });

Example response

json
{ "result": ["47.1.0", "47.0.50", "47.0.49"] }