Ricardoneud.com
DocumentationHelp Center
API Reference
  • Production
  • Sandbox (Coming Soon)
DocumentationHelp Center
API Reference
  • Production
  • Sandbox (Coming Soon)
Discord Community
Github
  1. Minecraft
  • Back to home
  • v3
  • Games
    • Minecraft
      • Get Minecraft Server
        GET
    • Fivem
      • Get Fivem Server
  • Reseller
    • Licenses
      • Check License
      • Generate License
      • Update License
      • Delete License
  • Tools
    • Get Subdomains
    • Mail DNS Checker
    • Get Domain Information
    • Get DNS Information
  • User Login
    POST
  1. Minecraft

Get Minecraft Server

Obsolete
GET
https://api.ricardoneud.com/v3/games/minecraft/lookup
This documentation helps you retrieve the status of a Minecraft server by providing its address and port.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
API Key
Add parameter in header
Basic
Example:
Basic: ********************
or
Header Params

Responses

🟢200Success
application/json

Fields in the Response:

ip: The IP address of the Minecraft server.
port: The port on which the Minecraft server is running.
players: Information about the number of players online and the maximum capacity.
online: The number of players currently online.
max: The maximum number of players the server can support.
version: Information about the server's version.
name: The name of the server version.
protocol: The protocol version number.
ping: The latency of the server in milliseconds.
srvRecord: The SRV record associated with the server, if available.

Error Responses

400 Bad Request: Missing address in headers.
401 Unauthorized: Invalid or missing API key, or insufficient permissions.
500 Internal Server Error: Database error or failed to perform Minecraft server check.
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.ricardoneud.com/v3/games/minecraft/lookup' \
--header 'X-Address;' \
--header 'X-Port;' \
--header 'Basic: <api-key>'
Response Response Example
{
    "ip": "192.168.1.1",
    "port": "25565",
    "players": {
        "online": 10,
        "max": 20
    },
    "version": {
        "name": "1.19.2",
        "protocol": 760
    },
    "ping": "50 ms",
    "srvRecord": {
        "host": "example.com",
        "port": 25565
    }
}
Modified at 2025-10-23 17:49:25
Next
Get Fivem Server
Built with