Developers & API

Integrate SukkuAPI into your own projects with our high-performance REST API.

API Reference

Getting Started

SukkuAPI provides fast, reliable, and mathematically accurate Minecraft profile data. All API requests must be made over HTTPS.

Base URL
https://api.sukku.dev
Authentication
Authorization: Bearer YOUR_API_KEY

API Keys & Quotas

Manage Keys

To start making requests, you need to generate an API Key from your Developer Dashboard. We provide different subscription tiers tailored to your project's scale:

  • Basic Tier: Ideal for testing and small applications (includes generous rate limits for non-commercial use).
  • Plus Tier: Designed for high-traffic Discord bots, enterprise trackers, and applications requiring elevated rate limits and priority support.

You can upgrade or manage your API Quotas at any time from your account settings.

Endpoints Overview

For full schemas and interactive testing, please visit our Interactive API Docs.

  • GET /api/v1/players/{nick}/history

    Returns the mathematically resolved name history of a player, caching the response for optimal latency.

  • GET /api/v1/players/{nick}/owners

    Returns a list of all UUIDs that have ever held the specified nickname.

  • GET /api/v1/servers/{ip}/ban/{nick}

    Checks the ban status of a player on specific supported servers.

Terms of Service

Please review our API usage rules, required headers, and anti-abuse policies before integrating.

Read Full Terms