Skip to main content
GET
/
v1
/
guilds
/
{guild_id}
curl https://hapi.7331.org/v1/guilds/987654321098765432 \
  -H "X-API-Key: $API_KEY"

{
  "discord_id": "987654321098765432",
  "name": "Example Server",
  "avatar_url": "https://cdn.discordapp.com/icons/987654321098765432/abc.png",
  "member_count": 150,
  "prefix": "!",
  "owner_discord_id": "123456789012345678",
  "state": 0,
  "source": "database",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T12:00:00Z"
}
Public access returns basic profile data. Moderators see extended detail with redacted subscription fields. Admins and above see full detail including subscription history.
​
guild_id
integer
required
Discord snowflake ID.
​
X-API-Key
string
Public API key (required for unauthenticated access).

​
Response

​
Public (unauthenticated or insufficient permissions)

​
discord_id
string
required
Discord guild ID.
​
name
string
required
Discord guild name.
​
avatar_url
string
Discord CDN icon URL.
​
member_count
integer
Number of members.
​
prefix
string
required
Command prefix for this guild.
​
owner_discord_id
string
Discord ID of the guild owner.
​
state
integer
Guild state. 0 = Active, 1 = Inactive, 2 = Banned.
​
created_at
string
required
When the guild was created (UTC).
​
updated_at
string
required
When the guild was last updated (UTC).

​
Elevated (moderator+ with hierarchy access)

All public fields plus:
​
subscription_tier
integer
Subscription tier. 0 = Basic, 1 = Trial, 2 = Premium, 3 = Lifetime. Redacted to 0 for moderators.
​
subscription_expires_at
string
Subscription expiry (admin+ only, null for moderators).
​
sponsored_by_id
string
Sponsor Discord ID (admin+ only, null for moderators).
​
is_blacklisted
boolean
Whether guild has an active blacklist.
​
punishments
object[]
Punishment history.
​
subscription_history
object[]
Subscription tier change history (admin+ only, empty for moderators).
curl https://hapi.7331.org/v1/guilds/987654321098765432 \
  -H "X-API-Key: $API_KEY"

{
  "discord_id": "987654321098765432",
  "name": "Example Server",
  "avatar_url": "https://cdn.discordapp.com/icons/987654321098765432/abc.png",
  "member_count": 150,
  "prefix": "!",
  "owner_discord_id": "123456789012345678",
  "state": 0,
  "source": "database",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T12:00:00Z"
}