Skip to main content
GET
/
events
/
{event_id}
Get Event With Stats
curl --request GET \
  --url https://api.securegate.ai/events/{event_id} \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "description": "<string>",
  "instructions": "<string>",
  "title": "<string>",
  "imageUrl": "<string>",
  "status": "<string>",
  "type": "fixed",
  "location": {
    "address": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zipCode": "<string>",
    "country": "<string>"
  },
  "start_timestamp": 123,
  "end_timestamp": 123,
  "is_deleted": true,
  "invite_stats": {
    "sent": 123,
    "accepted": 123,
    "pending": 123,
    "rejected": 123,
    "total": 123
  }
}
This endpoint retrieves detailed information about a specific event, including statistics about invitations. It’s perfect for building event dashboards and monitoring attendance. What it does:
  • Fetches complete information about a single event using its ID
  • Provides statistics about invitations (sent, accepted, pending, rejected)
  • Shows you the current status of your event and its attendance metrics
When to use it:
  • When building an event management dashboard
  • When you need to monitor invitation response rates
  • When checking how many people have accepted your invitations
  • Before an event to assess expected attendance

​
Path Parameters

ParameterTypeRequiredDescription
event_idstringYesThe unique identifier of the event to retrieve

​
Response

The API returns the event object with all its details, including invitation statistics: 
{
  "id": "event-123",
  "description": "Join us for the annual tech conference featuring speakers from top tech companies",
  "instructions": "Please arrive 30 minutes before the event starts for registration",
  "title": "Annual Tech Conference",
  "imageUrl": "https://example.com/event-image.jpg",
  "status": "upcoming",
  "type": "dated",
  "location": {
    "address": "123 Conference Center Dr",
    "city": "San Francisco",
    "state": "CA",
    "zipCode": "94105",
    "country": "USA"
  },
  "start_timestamp": 1677609600,
  "end_timestamp": 1677696000,
  "is_deleted": false,
  "invite_stats": {
    "sent": 150,
    "accepted": 75,
    "pending": 50,
    "rejected": 25,
    "total": 150
  }
}
The invite_stats field shows you:
  • How many invitations were sent total (total)
  • How many people have accepted your invitation (accepted)
  • How many haven’t responded yet (pending)
  • How many declined to attend (rejected)
This helps you gauge interest and plan accordingly for your event’s attendance.

Authorizations

​
x-api-key
string
header
required

API key authentication. Add your API key as the value of the 'x-api-key' header.

Path Parameters

​
event_id
string
required

Response

Successful Response

​
id
string
required
​
description
string
required
​
instructions
string
required
​
title
string
required
​
imageUrl
string
required
​
status
string
required
​
type
enum<string>
required
Available options:
fixed,
dated
​
location
object
required
​
is_deleted
boolean
required
​
invite_stats
object
required
​
start_timestamp
integer | null
​
end_timestamp
integer | null