MinecraftAuth.me

API documentation

Contents: Authentication

Authentication

Lookups work anonymously. Membership checks need credentials. There are two kinds:

Server tokens (creators)#

A creator's server token identifies you as a creator: membership checks answer "does this player follow, subscribe to or support me?". Every MinecraftAuth.me user can get one:

  1. Sign in at minecraftauth.me and link the platforms you want to check against (for example your Twitch channel).
  2. Open the Developers page. It shows your server token, ready to copy in both forms below, and can generate a new one. Generating a new token invalidates the old one.

Send it in either form:

Authorization: Basic MjphYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5ejAxMjM0NQ==
Authorization: Bearer abcdefghijklmnopqrstuvwxyz012345

The Basic form is base64(uid:token); the Bearer form is the 32-character token alone.

The older https://minecraftauth.me/api/token address still works and returns the Basic form, but it generates a new token every time it's opened.

Application credentials#

An application is a website, bot, plugin or other service that asks players for access through an access request. Players can approve an application to see accounts they keep private. To see what was approved, the application must authenticate:

Authorization: Basic base64(applicationId:secret)

Create and manage applications on the Developers page. Your account needs a linked Discord account, which owns the application. Each application has a 16-character ID, a secret and an optional list of allowed redirect URLs, and you can own at most 20. An application without redirect URLs asks players for access with request codes instead. The secret is shown only when it's created or rotated. Keep it on your server and never ship it in a client or plugin. If it leaks, rotate it on the Developers page.

When an application runs a membership check, it acts as the creator whose identity has the application owner's Discord account linked.

Which one do I need?#

You want to… Credentials
Look up public accounts none
Look up accounts players approved your application to see application
Check followers, subscribers, patrons or Discord membership for your own community server token (or application)

Wrong credentials are always an error (401/403), even on endpoints that work anonymously. A malformed header never quietly falls back to anonymous access.