{
  "openapi": "3.1.0",
  "info": {
    "title": "Astroworld Public Minecraft Data API",
    "version": "1.0.0",
    "description": "Read-only public Minecraft reference data. No account or API key is required. Contains no customer accounts, hosting servers, billing or administration operations. Existing limit: 100 API requests per IP per minute; honor Retry-After on HTTP 429. Filters use case-insensitive names and lowercase category values."
  },
  "servers": [
    {
      "url": "https://api.astroworldmc.com"
    }
  ],
  "security": [],
  "externalDocs": {
    "url": "https://api.astroworldmc.com/"
  },
  "paths": {
    "/v1/mobs": {
      "get": {
        "operationId": "listMobs",
        "summary": "List public Minecraft mobs",
        "tags": [
          "mobs"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned type field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned category field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Mobs"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/mobs/{name}": {
      "get": {
        "operationId": "getMobsRecord",
        "summary": "Get one public Minecraft mobs record",
        "tags": [
          "mobs"
        ],
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "cow"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Mobs"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/biomes": {
      "get": {
        "operationId": "listBiomes",
        "summary": "List public Minecraft biomes",
        "tags": [
          "biomes"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dimension",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned dimension field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned category field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "rarity",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned rarity field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Biomes"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/biomes/{name}": {
      "get": {
        "operationId": "getBiomesRecord",
        "summary": "Get one public Minecraft biomes record",
        "tags": [
          "biomes"
        ],
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "minecraft:plains"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Biomes"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/items": {
      "get": {
        "operationId": "listItems",
        "summary": "List public Minecraft items",
        "tags": [
          "items"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned category field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Items"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/items/{name}": {
      "get": {
        "operationId": "getItemsRecord",
        "summary": "Get one public Minecraft items record",
        "tags": [
          "items"
        ],
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "wooden_pickaxe"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Items"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/enchantments": {
      "get": {
        "operationId": "listEnchantments",
        "summary": "List public Minecraft enchantments",
        "tags": [
          "enchantments"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned category field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Enchantments"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/enchantments/{name}": {
      "get": {
        "operationId": "getEnchantmentsRecord",
        "summary": "Get one public Minecraft enchantments record",
        "tags": [
          "enchantments"
        ],
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "sharpness"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Enchantments"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/structures": {
      "get": {
        "operationId": "listStructures",
        "summary": "List public Minecraft structures",
        "tags": [
          "structures"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dimension",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned dimension field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned category field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "rarity",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned rarity field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Structures"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/structures/{name}": {
      "get": {
        "operationId": "getStructuresRecord",
        "summary": "Get one public Minecraft structures record",
        "tags": [
          "structures"
        ],
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "village"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Structures"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/commands": {
      "get": {
        "operationId": "listCommands",
        "summary": "List public Minecraft commands",
        "tags": [
          "commands"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned category field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "permissionLevel",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned permissionLevel field.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Commands"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/commands/{name}": {
      "get": {
        "operationId": "getCommandsRecord",
        "summary": "Get one public Minecraft commands record",
        "tags": [
          "commands"
        ],
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "give"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Commands"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/versions": {
      "get": {
        "operationId": "listVersions",
        "summary": "List public Minecraft versions",
        "tags": [
          "versions"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of version name or updateName.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned type field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "edition",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned edition field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Versions"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/versions/{version}": {
      "get": {
        "operationId": "getVersionsRecord",
        "summary": "Get one public Minecraft versions record",
        "tags": [
          "versions"
        ],
        "parameters": [
          {
            "name": "version",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "1-0"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Versions"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/achievements": {
      "get": {
        "operationId": "listAchievements",
        "summary": "List public Minecraft achievements",
        "tags": [
          "achievements"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tab",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned tab field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "difficulty",
            "in": "query",
            "required": false,
            "description": "Filter by an exact value in the returned difficulty field.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Achievements"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/achievements/{slug}": {
      "get": {
        "operationId": "getAchievementsRecord",
        "summary": "Get one public Minecraft achievements record",
        "tags": [
          "achievements"
        ],
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "minecraft"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Achievements"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/trades": {
      "get": {
        "operationId": "listTrades",
        "summary": "List public Minecraft trades",
        "tags": [
          "trades"
        ],
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pretty",
            "in": "query",
            "required": false,
            "description": "Pretty-print JSON when set to true.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching public records; an empty match is HTTP 200 with data: [].",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "count",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Trades"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    },
    "/v1/trades/{id}": {
      "get": {
        "operationId": "getTradesRecord",
        "summary": "Get one public Minecraft trades record",
        "tags": [
          "trades"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Use the identifier or name from the list endpoint. URL-encode the value.",
            "schema": {
              "type": "string"
            },
            "example": "armorer"
          }
        ],
        "responses": {
          "200": {
            "description": "Public reference record.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "data"
                  ],
                  "properties": {
                    "success": {
                      "const": true
                    },
                    "data": {
                      "$ref": "#/components/schemas/Trades"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Record not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "API request limit exceeded. Wait for Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds remaining in the limit window."
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "const": false
          },
          "error": {
            "type": "string"
          }
        }
      },
      "Mobs": {
        "type": "object",
        "properties": {
          "behavior": {
            "type": "string"
          },
          "breedable": {
            "type": "boolean"
          },
          "breedingItem": {
            "type": [
              "null",
              "string"
            ]
          },
          "category": {
            "type": "string"
          },
          "damage": {
            "type": "object"
          },
          "drops": {
            "type": "array",
            "items": {}
          },
          "hp": {
            "type": "integer"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "spawnBiomes": {
            "type": "array",
            "items": {}
          },
          "spawnConditions": {
            "type": "string"
          },
          "tameable": {
            "type": "boolean"
          },
          "tamingMethod": {
            "type": [
              "null",
              "string"
            ]
          },
          "type": {
            "type": "string"
          },
          "versionAdded": {
            "type": "string"
          },
          "weaknesses": {
            "type": "array",
            "items": {}
          },
          "xpDrop": {
            "type": "object"
          }
        },
        "additionalProperties": true
      },
      "Biomes": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string"
          },
          "colors": {
            "type": "object"
          },
          "dimension": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "precipitation": {
            "type": "string"
          },
          "rarity": {
            "type": "string"
          },
          "spawningMobs": {
            "type": "array",
            "items": {}
          },
          "structuresFound": {
            "type": "array",
            "items": {}
          },
          "temperature": {
            "type": [
              "integer",
              "number"
            ]
          },
          "terrainFeatures": {
            "type": "array",
            "items": {}
          },
          "uniqueBlocks": {
            "type": "array",
            "items": {}
          },
          "versionAdded": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "Items": {
        "type": "object",
        "properties": {
          "applicableEnchantments": {
            "type": "array",
            "items": {}
          },
          "category": {
            "type": "string"
          },
          "craftingRecipe": {
            "type": [
              "null",
              "object"
            ]
          },
          "description": {
            "type": "string"
          },
          "durability": {
            "type": [
              "integer",
              "null"
            ]
          },
          "enchantable": {
            "type": "boolean"
          },
          "foodValue": {
            "type": [
              "null",
              "object"
            ]
          },
          "fuelValue": {
            "type": [
              "integer",
              "null"
            ]
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "obtainedBy": {
            "type": "array",
            "items": {}
          },
          "stackSize": {
            "type": "integer"
          },
          "versionAdded": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "Enchantments": {
        "type": "object",
        "properties": {
          "applicableItems": {
            "type": "array",
            "items": {}
          },
          "category": {
            "type": "string"
          },
          "curseOf": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          },
          "effectPerLevel": {
            "type": "array",
            "items": {}
          },
          "id": {
            "type": "string"
          },
          "incompatibleWith": {
            "type": "array",
            "items": {}
          },
          "maxLevel": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "obtainedFrom": {
            "type": "array",
            "items": {}
          },
          "treasureOnly": {
            "type": "boolean"
          },
          "versionAdded": {
            "type": "string"
          },
          "weight": {
            "type": "integer"
          }
        },
        "additionalProperties": true
      },
      "Structures": {
        "type": "object",
        "properties": {
          "biomes": {
            "type": "array",
            "items": {}
          },
          "category": {
            "type": "string"
          },
          "dangers": {
            "type": "array",
            "items": {}
          },
          "dimension": {
            "type": "string"
          },
          "features": {
            "type": "array",
            "items": {}
          },
          "hostileMobs": {
            "type": "array",
            "items": {}
          },
          "howToFind": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "loot": {
            "type": "array",
            "items": {}
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "rarity": {
            "type": "string"
          },
          "rewards": {
            "type": "array",
            "items": {}
          },
          "uniqueLoot": {
            "type": "array",
            "items": {}
          },
          "versionAdded": {
            "type": "string"
          },
          "yLevel": {
            "type": "object"
          }
        },
        "additionalProperties": true
      },
      "Commands": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string"
          },
          "commonMistakes": {
            "type": "array",
            "items": {}
          },
          "description": {
            "type": "string"
          },
          "examples": {
            "type": "array",
            "items": {}
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "parameters": {
            "type": "array",
            "items": {}
          },
          "permissionLevel": {
            "type": "integer"
          },
          "relatedCommands": {
            "type": "array",
            "items": {}
          },
          "syntax": {
            "type": "string"
          },
          "versionAdded": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "Versions": {
        "type": "object",
        "properties": {
          "edition": {
            "type": "string"
          },
          "majorFeatures": {
            "type": "array",
            "items": {}
          },
          "name": {
            "type": "string"
          },
          "nextVersion": {
            "type": [
              "null",
              "string"
            ]
          },
          "notableChanges": {
            "type": "array",
            "items": {}
          },
          "notableFixes": {
            "type": "array",
            "items": {}
          },
          "previousVersion": {
            "type": [
              "null",
              "string"
            ]
          },
          "releaseDate": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "updateName": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "Achievements": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "difficulty": {
            "type": "string"
          },
          "howToComplete": {
            "type": "string"
          },
          "icon": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "isChallenge": {
            "type": "boolean"
          },
          "isGoal": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "parent": {
            "type": [
              "null",
              "string"
            ]
          },
          "prerequisites": {
            "type": "array",
            "items": {}
          },
          "rewards": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "tab": {
            "type": "string"
          },
          "versionAdded": {
            "type": "string"
          },
          "xpReward": {
            "type": "integer"
          }
        },
        "additionalProperties": true
      },
      "Trades": {
        "type": "object",
        "properties": {
          "biomeSpecific": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "levels": {
            "type": "array",
            "items": {}
          },
          "name": {
            "type": "string"
          },
          "workstation": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    }
  }
}