Skip to main content

​
How to authenticate with Mint API

All Mint API endpoints mandate authentication via Bearer tokens, providing secure access for sensitive actions such as account mapping and database management.

​
Obtaining a Key

  1. Apply for a API Key by opening a Developer Support Ticket inside of the Mint Systems Discord Server.
  2. Use API Key as your Berear Token for Authentication
Ensure to keep your API Key secure. Do not leave it out inside client-side code or public Github Repositories

​
Key Types

We offer two types of API Keys that you can apply for.
  1. Guild-Only Key – This key has no request limits and a 2-second rate limit. However, it can only be used in the server where it was registered.
  2. Global Key – This key has no request limits and no rate limit. It can be used in any server.

​
Using the API Key

Ensure to include the API Key inside of the Authorization header of your request. Examples can be found below. 
curl -H "x-api-key: YOUR_API_KEY" \
-H "x-guild-id: 987654321" \
"https://api.mintsys.xyz/v1/api/public/discord-to-roblox?discordId=123456789"

​
Error Handling

If your authentication to the API fails, you will receive a 401 Unauthorized response from the API. Example below: 
{
  "status": 401,
  "error": "Unauthorized: Invalid API key",
  "timestamp": "2026-02-12T12:00:00Z",
  "version": "1.2.1"
}
We provide a ready-to-use public utility file that makes integrating the Mint API effortless. With this file, you can quickly fetch Roblox and Discord information.
https://github.com/mintrblx/utils