What is the Discord API base URL?

The Discord API base URL is https://discord.com/api/v10

Does Discord API have a free tier?

Yes. Full API access is free for bots and apps

Discord API — Base URL, Auth & Endpoints

The Discord API powers bots, integrations, and OAuth apps on the Discord platform. Create and manage channels, send messages and embeds, assign roles, listen to events via WebSocket Gateway, implement slash commands and context menus, manage server members, and integrate with Discord's voice channels. Used for community bots, game integrations, developer tools, and notification systems. Supports both bot tokens and OAuth2 for user-scoped actions.

Quick Reference

Base URL https://discord.com/api/v10 Auth type Bearer Token Auth header Authorization: Bot MTk4NjIyNDgzNDcxOTI1MjQ4.GlLjkw.abc Rate limit 50 requests/sec global · Per-route limits vary (most routes: 5 req/5 sec) Pricing Free tier available Free quota Full API access is free for bots and apps Documentation https://discord.com/developers/docs Endpoint status Server online — HTTP 404 — server is online but path returned an error (may require auth)1.04s (checked Mar 29, 2026) Builder score B 70% builder-friendly

Pricing

Latency

Depth

Authentication

Bot token: prefix with "Bot " (e.g., "Bot MTk4NjIyNDgzNDcxOTI1MjQ4.GlLjkw.abc"). OAuth2 Bearer token for user-scoped actions. Create an application at discord.com/developers.

Authorization: Bot MTk4NjIyNDgzNDcxOTI1MjQ4.GlLjkw.abc

Pricing

Model freemium Starting price Free tier available Free quota Full API access is free for bots and apps

The Discord API is free to use. Discord monetizes via Nitro subscriptions and server boosts. No API usage fees for developers.

Key Endpoints

Method	Path	Description
POST	`/channels/{channel_id}/messages`	Send a message to a channel
GET	`/guilds/{guild_id}`	Get server (guild) info and settings
GET	`/guilds/{guild_id}/members`	List members in a server
PUT	`/guilds/{guild_id}/members/{user_id}/roles/{role_id}`	Add a role to a member
POST	`/applications/{app_id}/commands`	Register a global slash command
GET	`/users/@me`	Get the current bot or OAuth user info

Sample Request

curl "https://discord.com/api/v10/channels/$CHANNEL_ID/messages" \
  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"content":"Hello from API Map!","embeds":[{"title":"API Directory","color":8531955,"description":"50+ APIs for developers"}]}'

Sample Response

{
  "id": "1234567890123456789",
  "channel_id": "987654321098765432",
  "content": "Hello from API Map!",
  "author": { "id": "111", "username": "MyBot", "bot": true },
  "timestamp": "2024-03-15T10:00:00.000000+00:00",
  "embeds": [{ "title": "API Directory", "color": 8531955 }]
}