# NewMinecraftServers API

**Canonical:** https://apis.io/apis/newminecraftservers/newminecraftservers-api/  
**Provider:** NewMinecraftServers — https://apis.io/providers/newminecraftservers/  
**Base URL:** https://newminecraftservers.net/api/v1  
**Documentation:** https://newminecraftservers.net/minecraft-api

NewMinecraftServers API is published by [NewMinecraftServers](https://apis.io/providers/newminecraftservers/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 4 JSON Schemas.

Free, no-key read-only API for discovering published Minecraft servers and reading cached Minecraft service status. Five GET endpoints under /api/v1: server search/list, address lookup, server detail, public player-count history, and Minecraft service status. JSON over HTTPS with CORS enabled.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/servers` | Search and list published servers |
| GET | `/servers/lookup` | Find a published listing by its stored address |
| GET | `/servers/{slug}` | Get one published server |
| GET | `/servers/{slug}/history` | Get public player-count and uptime history |
| GET | `/minecraft-status` | Get cached Minecraft service health |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/newminecraftservers/refs/heads/main/openapi/newminecraftservers-openapi.yml
- **OpenAPI** — https://newminecraftservers.net/openapi.json
- **Documentation** — https://newminecraftservers.net/minecraft-api
- **APIReference** — https://newminecraftservers.net/minecraft-api
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newminecraftservers/refs/heads/main/json-schema/newminecraftservers-minecraft-status-envelope-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newminecraftservers/refs/heads/main/json-schema/newminecraftservers-server-history-envelope-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newminecraftservers/refs/heads/main/json-schema/newminecraftservers-server-detail-envelope-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newminecraftservers/refs/heads/main/json-schema/newminecraftservers-server-list-envelope-schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/newminecraftservers/refs/heads/main/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/newminecraftservers/newminecraftservers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/newminecraftservers/.