Skip to main content
GET
/
v1
/
admin
/
punishments
/
{punishment_id}
curl https://hapi.7331.org/v1/admin/punishments/42 \
  -b cookies.txt

{
  "id": 42,
  "discord_user_id": "123456789012345678",
  "discord_guild_id": null,
  "punishment_type": "BAN",
  "discord_issued_by_id": "999888777666555444",
  "reason": "Terms of service violation",
  "expires_at": null,
  "is_lifted": false,
  "lifted_at": null,
  "discord_lifted_by_id": null,
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}
Requires an active admin session cookie.
​
punishment_id
integer
required
Punishment database ID.

​
Response

Returns the full punishment record.
​
id
integer
required
Punishment database ID.
​
discord_user_id
string
Punished user’s Discord ID (null if guild punishment).
​
discord_guild_id
string
Punished guild’s Discord ID (null if user punishment).
​
punishment_type
string
required
One of: WARNING, TIMEOUT, BAN, GUILD_BLACKLIST.
​
discord_issued_by_id
string
required
Issuer’s Discord ID.
​
reason
string
Reason for punishment.
​
expires_at
string
Expiration timestamp (ISO 8601). null for permanent.
​
is_lifted
boolean
required
Whether the punishment has been lifted.
curl https://hapi.7331.org/v1/admin/punishments/42 \
  -b cookies.txt

{
  "id": 42,
  "discord_user_id": "123456789012345678",
  "discord_guild_id": null,
  "punishment_type": "BAN",
  "discord_issued_by_id": "999888777666555444",
  "reason": "Terms of service violation",
  "expires_at": null,
  "is_lifted": false,
  "lifted_at": null,
  "discord_lifted_by_id": null,
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}