Skip to main content
GET
/
guilds
/
{guild_id}
/
audit-logs
cURL
curl --request GET \
  --url https://discord.com/api/v10/guilds/{guild_id}/audit-logs \
  --header 'Authorization: <api-key>'
{
  "audit_log_entries": [
    {
      "id": "<string>",
      "action_type": 123,
      "user_id": "<unknown>",
      "target_id": "<unknown>",
      "changes": [
        {
          "key": "<string>",
          "new_value": "<unknown>",
          "old_value": "<unknown>"
        }
      ],
      "options": {},
      "reason": "<string>"
    }
  ],
  "users": [
    {
      "id": "<string>",
      "username": "<string>",
      "avatar": "<string>",
      "discriminator": "<string>",
      "public_flags": 123,
      "flags": 0,
      "global_name": "<string>",
      "primary_guild": "<unknown>",
      "bot": true,
      "system": true,
      "banner": "<string>",
      "accent_color": 123,
      "avatar_decoration_data": "<unknown>",
      "collectibles": "<unknown>"
    }
  ],
  "integrations": [
    {
      "id": "<string>",
      "type": "discord",
      "name": "<string>",
      "account": {
        "id": "<string>",
        "name": "<string>"
      },
      "application_id": "<string>"
    }
  ],
  "webhooks": [
    {
      "application_id": "<unknown>",
      "avatar": "<string>",
      "channel_id": "<unknown>",
      "id": "<string>",
      "name": "<string>",
      "type": 3,
      "guild_id": "<unknown>",
      "user": {
        "id": "<string>",
        "username": "<string>",
        "avatar": "<string>",
        "discriminator": "<string>",
        "public_flags": 123,
        "flags": 0,
        "global_name": "<string>",
        "primary_guild": "<unknown>",
        "bot": true,
        "system": true,
        "banner": "<string>",
        "accent_color": 123,
        "avatar_decoration_data": "<unknown>",
        "collectibles": "<unknown>"
      }
    }
  ],
  "guild_scheduled_events": [
    {
      "id": "<string>",
      "guild_id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "channel_id": "<unknown>",
      "creator_id": "<unknown>",
      "image": "<string>",
      "scheduled_start_time": "2023-11-07T05:31:56Z",
      "scheduled_end_time": "2023-11-07T05:31:56Z",
      "status": 123,
      "entity_type": 3,
      "entity_id": "<unknown>",
      "privacy_level": 123,
      "entity_metadata": {
        "location": "<string>"
      },
      "creator": {
        "id": "<string>",
        "username": "<string>",
        "avatar": "<string>",
        "discriminator": "<string>",
        "public_flags": 123,
        "flags": 0,
        "global_name": "<string>",
        "primary_guild": "<unknown>",
        "bot": true,
        "system": true,
        "banner": "<string>",
        "accent_color": 123,
        "avatar_decoration_data": "<unknown>",
        "collectibles": "<unknown>"
      },
      "user_count": 123,
      "user_rsvp": "<unknown>"
    }
  ],
  "threads": [
    {
      "id": "<string>",
      "type": 10,
      "flags": 123,
      "guild_id": "<string>",
      "name": "<string>",
      "owner_id": "<string>",
      "thread_metadata": {
        "archived": true,
        "archive_timestamp": "2023-11-07T05:31:56Z",
        "auto_archive_duration": 123,
        "locked": true,
        "create_timestamp": "2023-11-07T05:31:56Z",
        "invitable": true
      },
      "message_count": 123,
      "member_count": 123,
      "total_message_sent": 123,
      "last_message_id": "<unknown>",
      "last_pin_timestamp": "2023-11-07T05:31:56Z",
      "parent_id": "<unknown>",
      "rate_limit_per_user": 123,
      "bitrate": 123,
      "user_limit": 123,
      "rtc_region": "<string>",
      "video_quality_mode": 123,
      "permissions": "<string>",
      "applied_tags": [
        "<string>"
      ],
      "member": {
        "id": "<string>",
        "user_id": "<string>",
        "join_timestamp": "2023-11-07T05:31:56Z",
        "flags": 123,
        "member": {
          "avatar": "<string>",
          "banner": "<string>",
          "communication_disabled_until": "2023-11-07T05:31:56Z",
          "flags": 123,
          "joined_at": "2023-11-07T05:31:56Z",
          "nick": "<string>",
          "pending": true,
          "premium_since": "2023-11-07T05:31:56Z",
          "roles": [
            "<string>"
          ],
          "user": {
            "id": "<string>",
            "username": "<string>",
            "avatar": "<string>",
            "discriminator": "<string>",
            "public_flags": 123,
            "flags": 0,
            "global_name": "<string>",
            "primary_guild": "<unknown>",
            "bot": true,
            "system": true,
            "banner": "<string>",
            "accent_color": 123,
            "avatar_decoration_data": "<unknown>",
            "collectibles": "<unknown>"
          },
          "mute": true,
          "deaf": true,
          "avatar_decoration_data": "<unknown>",
          "collectibles": "<unknown>"
        }
      }
    }
  ],
  "application_commands": [
    {
      "id": "<string>",
      "application_id": "<string>",
      "version": "<string>",
      "default_member_permissions": "<string>",
      "type": 123,
      "name": "<string>",
      "description": "<string>",
      "name_localized": "<string>",
      "name_localizations": {},
      "description_localized": "<string>",
      "description_localizations": {},
      "guild_id": "<string>",
      "dm_permission": true,
      "contexts": [
        123
      ],
      "integration_types": [
        123
      ],
      "options": [
        {
          "type": 11,
          "name": "<string>",
          "description": "<string>",
          "name_localized": "<string>",
          "name_localizations": {},
          "description_localized": "<string>",
          "description_localizations": {},
          "required": true
        }
      ],
      "nsfw": true
    }
  ],
  "auto_moderation_rules": [
    {
      "id": "<string>",
      "guild_id": "<string>",
      "creator_id": "<string>",
      "name": "<string>",
      "event_type": 123,
      "actions": [
        {
          "type": 1,
          "metadata": {
            "custom_message": "<string>"
          }
        }
      ],
      "trigger_type": 4,
      "enabled": true,
      "exempt_roles": [
        "<string>"
      ],
      "exempt_channels": [
        "<string>"
      ],
      "trigger_metadata": {
        "allow_list": [
          "<string>"
        ],
        "presets": [
          123
        ]
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

guild_id
string<snowflake>
required

Query Parameters

user_id
string<snowflake>
target_id
string<snowflake>
action_type
before
string<snowflake>
after
string<snowflake>
limit
integer
Required range: 1 <= x <= 100

Response

200 response for list_guild_audit_log_entries

audit_log_entries
object[]
required
users
object[]
required
integrations
object[]
required
webhooks
object[]
required
guild_scheduled_events
object[]
required
threads
object[]
required
application_commands
object[]
required
auto_moderation_rules
object · object · object · object · object · null[]
required