Minecraft Server Status API

⭐ Beginner's Pick Games & Comics / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

Overview

The Minecraft Server Status API lets you check whether a Minecraft server is online and retrieve its player count, version, and MOTD without connecting to the server yourself. It works for both Java and Bedrock edition servers, and requires no API key. This is perfect for server dashboards, bots, or community websites.

💡

Beginner Tip

Use the /2/server/status/java/{host} endpoint to check any public Java server — replace {host} with the server address (e.g. hypixel.net). The response tells you online status, player count, and server version at a glance.

Available Data

Minecraft Server Status data via REST API
JSON-formatted response data
Freely accessible without authentication

Example Response

JSON Response
{
  "id": 1,
  "name": "Minecraft Server Status",
  "data": "API to get Information about a Minecraft Server",
  "source": "Minecraft Server Status"
}

Field Reference

online True if the server responded to the status ping, false if it is offline or unreachable
players Player information with online (current count) and max (server capacity) fields
version The Minecraft version string the server is running (e.g. 1.20.1)
motd Message of the day in raw and clean formats; clean strips color codes for easy display
icon Base64-encoded PNG of the server icon, ready to use as an img src data URI

Implementation Example

const url = "https://api.mcsrvstat.us/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

online: false even for a running server The target Minecraft server may have blocked external pings, or the hostname could be wrong
Verify the server address is correct and try connecting manually in Minecraft. Some servers disable the ping response in their config.
Cached stale data The API caches results for a few minutes to reduce load on Minecraft servers
The cache TTL is typically 5 minutes — display the cached_at or debug.cachetime field in your UI so users know when data was last refreshed
CORS errors in browser Browser security policy blocking direct API calls from a frontend app
Proxy the request through your backend server, or use a serverless function to call the Minecraft Status API and return the result to your frontend

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 7/15
Response Time 47ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS NO
Category Games & Comics
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →