ProtectCord API

IP intelligence, threat detection, and security lookups for your applications.

Getting Started

Need an API Key?

Get your API key from the ProtectCord Dashboard. The Minecraft plugin can also generate keys automatically.

Authentication

Pass your API key as a query parameter:

GET https://api.protectcord.com/checkip/1.1.1.1?key=YOUR_API_KEY

Rate Limits

Default: 32 requests/minute. Check response headers X-RateLimit-Remaining and X-RateLimit-Reset.

Error Codes

Public Endpoints

No authentication required.

GET /health

System health status and diagnostics.

GET /stats

Public usage statistics and threat intelligence summary.

GET /myip

Get your public IP. Add ?detailed=true for full analysis.

GET /plugin-version

Get latest Minecraft plugin version.

Authenticated Endpoints

Require a valid API key.

IP Intelligence

GET /checkip/{ip}

Comprehensive IP analysis with security flags, geolocation, and company info.

Security flags: is_vpn, is_proxy, is_tor, is_datacenter, is_residential_vpn_or_proxy, is_abuser, is_whitelisted, is_blacklisted

GET /checkip/8.8.8.8?key=YOUR_KEY

Lookups

GET /lookup/discord/{user_id}

Look up Discord user by ID.

GET /lookup/discord/123456789012345678?key=YOUR_KEY

GET /lookup/minecraft/{username}

Look up Minecraft player. Returns UUID, skin, cape, name history.

GET /lookup/minecraft/Notch?key=YOUR_KEY

GET /lookup/minecraft-server/{address}

Query Minecraft server status, players, MOTD.

GET /lookup/minecraft-server/mc.hypixel.net?key=YOUR_KEY

GET /lookup/fivem/{identifier}

Look up FiveM player by identifier.

GET /lookup/fivem/steam:110000112345678?key=YOUR_KEY
${adminSection}