/auditlog

Returns up-to 100 recent events from the guild audit log

This endpoint supports the Exclude header

This endpoint is only on the BETA Version of the API and may be unstable.

Please report any & all bugs to the Support Server

Endpoint Headers:

• bot-token - Token of the Bot [String] (Required)

• guild-id - GuildId to fetch [Snowflake] (Required)

• apikey - Your Api Auth Key [String] (Required)

Examples:

Data API version required. Must replace <version> with either release or beta.

Bot Designer for Discord

Example usage of /auditlog endpoint using BDFD

$httpAddHeader[apikey;<YOUR-API-KEY>]
$httpAddHeader[bot-token;<YOUR-BOT-TOKEN>]
$httpAddHeader[guild-id;1064098700307218463]
$httpGet[https://bdfddata.rickyjs.xyz/<version>/auditlog]


$httpResult OR $httpResult[details]

Discord.js

Example usage of /auditlog endpoint using Discord.js

const axios = require('axios');
(async () => {
return await axios.get('https://bdfddata.rickyjs.xyz/<version>/auditlog', {
headers: {
"apikey": "<YOUR-API-KEY>",
"bot-token": "<YOUR-BOT-TOKEN>"
"guild-id": "1064098700307218463"
}
}).then(res=>res.data)
})()

Possible Responses (Codes)

Code 200

API succeeded and details were fetched.

{
  status: 200,
  details: {
        "audit_log_entries": [{
            "id": "1384835562552168521",
            "action_type": "MessagePin",
            "user_id": "600824086943367168",
            "target_id": "600824086943367168",
            "options": {
                "channel_id": "1071036587728711720",
                "message_id": "1384835548518158376"
            }
        }]
    }
    
    // Read more on Audit Log Objects: https://discord.com/developers/docs/resources/audit-log#audit-log-object

Code 400

An error occurred that stopped execution.

{
    status: 400
    error: 'Cannot read ...  (This can vary)'
}

Code 401

Invalid bot token was provided.

{
  status: 401,
  details: { message: '401: Unauthorized', code: 0 }
}