Discord Permissions Calculator
Convert Permission Bitfields to Names via API
Turn a Discord permissions bitfield into readable permission names, or an array of names back into the combined 64-bit integer, with one REST call. No bit-shifting, no lookup tables to maintain.
What it checks
Bitfield to names
Decode any permissions integer into the exact permission flags it grants.
Names to bitfield
Combine an array of permission names into the single integer Discord wants.
ADMINISTRATOR detection
Instantly flags the all-powerful ADMINISTRATOR permission.
Unknown-bit reporting
Surfaces any bits that don't map to a known permission.
Try it live
Click “Run review” to see the JSON response.
Quickstart
One authenticated POST request. Official JavaScript and Python SDKs available.
curl -X POST https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-permissions-calc \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"permissions":"274877990912"}' const res = await fetch(
"https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-permissions-calc",
{
method: "POST",
headers: {
Authorization: "Bearer YOUR_TOKEN",
"Content-Type": "application/json",
},
body: JSON.stringify({ permissions: "274877990912" }),
},
);
const { result } = await res.json();
console.log(result.permission_names);import requests
r = requests.post(
"https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-permissions-calc",
headers={"Authorization": "Bearer YOUR_TOKEN"},
json={"permissions": "274877990912"},
)
print(r.json()["result"]["permission_names"])Common use cases
Bot invite links
Compute the exact permissions integer for an OAuth2 invite URL.
Role management
Show admins human-readable permissions when editing roles.
Dashboards
Render a role's granted permissions in a bot control panel.
Permission audits
Flag over-privileged roles by decoding their bitfields.
Simple, pay-as-you-go pricing
Pay only for what you use, with no subscription. See full pricing.
When to use the Discord permissions calculator API
Permission integers are one of the easiest things to get wrong when building a Discord bot. A single miscalculated bit means your bot is missing EMBED_LINKS in production, or worse, that an invite link grants ADMINISTRATOR to a bot that only needs to send messages. Doing the bit math by hand, or copying a magic number from a forum post, does not scale and is hard to audit.
The Discord permissions calculator API removes the guesswork: send a bitfield and get back the exact list of permissions it grants, or send the names you want and get back the single integer Discord expects. Because it is a stateless REST endpoint, it slots cleanly into an invite-link builder, a role-management dashboard, or a CI check that fails when a role is over-privileged. Pair it with the Discord API suite to cover intents, invites, and moderation from one API key.
Frequently asked questions
What is a Discord permissions bitfield?
Discord stores a role or member's permissions as a single 64-bit integer where each bit represents one permission (for example SEND_MESSAGES or BAN_MEMBERS). This Discord permissions calculator translates that integer to and from readable names.
Can it convert permission names back into an integer?
Yes. Send an array of permission names instead of a bitfield and the API returns the combined integer you can drop into a bot-invite URL or a role edit.
Does it cover every Discord permission?
Yes. It covers the full 64-bit permission set, flags ADMINISTRATOR separately, and reports any unknown bits so you can catch new or deprecated permissions.
How much does the Discord permissions calculator API cost?
Each call costs 1 credit. Every new account gets 100 free credits, and credit packs start at $5, with no subscription and credits that never expire.
Do I need my bot token to use it?
No. This endpoint performs the calculation locally and never contacts Discord, so your bot token is never required or transmitted.
Start building in under a minute
Create a free account and get 100 credits. No card required.
Get your API key