API v2 · Events

Fetch one event

GET/v2/events/{eventId}

Last updated 1 October 2026

Overview

Permission scope: events.read
Community feature: events
Content type: application/json

Authentication

Send Authorization: Bearer YOUR_API_KEY and X-Clan-Id: COMMUNITY_ID. The community API switch and key must be enabled. The key must have the scope shown above. See authentication and key storage.

Parameters

Name	Location	Type	Required	Constraints and description
`eventId`	path	`string (uuid)`	Yes	The event's stable UUID.

Error responses

Status	When it is returned
400	The request was malformed or failed validation.
401	The API key is missing, malformed, or not recognised for this community.
403	The key is disabled, lacks the required permission, or the community's subscription or tier does not cover API access or this feature.

Server-side examples

After HTTP requests are enabled, Roblox Lua uses HttpService:GetSecret() from a server Script, never a LocalScript.

Request

GET

curl --request GET \
  --url 'https://api.clanlabs.co/v2/events/8ca14e0a-60cb-4b43-8a91-0c77bc521d81' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'X-Clan-Id: COMMUNITY_ID'

Response

200

The event

{
  "data": {
    "eventId": "00000000-0000-4000-8000-000000000000",
    "name": "EXAMPLE_NAME",
    "type": {
      "id": "128d8545-92ce-46d5-9f04-6ed803bbd351",
      "name": "Training",
      "quota": {
        "hostPoints": 1,
        "coHostPoints": 1
      },
      "experience": {
        "hostExperience": 1,
        "coHostExperience": 1,
        "attendeeExperience": 1
      },
      "defaultMentionRoleId": "YOUR_DEFAULT_MENTION_ROLE_ID"
    },
    "location": "YOUR_LOCATION",
    "status": "Scheduled",
    "host": {
      "discordId": "YOUR_DISCORD_ID",
      "robloxId": 1234567,
      "robloxName": "PixelComet482"
    },
    "coHost": {
      "discordId": "YOUR_DISCORD_ID",
      "robloxId": 1234567,
      "robloxName": "PixelComet482"
    },
    "mentionRoleId": "YOUR_MENTION_ROLE_ID",
    "notes": "YOUR_NOTES",
    "attendees": [
      {
        "discordId": "YOUR_DISCORD_ID",
        "robloxId": 1234567,
        "robloxName": "PixelComet482"
      }
    ],
    "proof": {
      "channelId": "YOUR_CHANNEL_ID",
      "messageId": "YOUR_MESSAGE_ID",
      "attachmentId": "YOUR_ATTACHMENT_ID",
      "filename": "YOUR_FILENAME",
      "contentType": "YOUR_CONTENT_TYPE",
      "size": 1
    },
    "announcement": {
      "channelId": "YOUR_CHANNEL_ID",
      "messageId": "YOUR_MESSAGE_ID"
    },
    "startedAt": 1735689600000,
    "finishedAt": 1735689600000,
    "cancelledAt": 1735689600000,
    "createdAt": 1735689600000,
    "lastUpdatedAt": 1735689600000
  }
}

Fetch one event | Clan Labs API

OverviewCopy link to overview

AuthenticationCopy link to authentication

ParametersCopy link to parameters

Error responsesCopy link to error responses

Rate limitsCopy link to rate limits

Related endpointsCopy link to related endpoints

Response

Overview

Authentication

Parameters

Error responses

Rate limits

Related endpoints