Skip to main content
GET
/
events
/
{id}
curl -X GET "https://api.tktchurch.com/v1/events/123e4567-e89b-12d3-a456-426614174000" \
  -H "Accept: application/json"
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Sunday Worship Service",
  "description": "Weekly Sunday worship service",
  "startDate": "2024-01-07T10:00:00Z",
  "endDate": "2024-01-07T12:00:00Z",
  "timezone": "America/New_York",
  "location": {
    "name": "Main Sanctuary",
    "address": "123 Church Street",
    "city": "New York",
    "state": "NY",
    "country": "USA",
    "postalCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.0060
    }
  },
  "type": "service",
  "status": "scheduled",
  "recurrence": {
    "frequency": "weekly",
    "interval": 1,
    "byDay": ["SU"]
  },
  "reminders": [
    {
      "type": "email",
      "minutes": 1440
    },
    {
      "type": "notification",
      "minutes": 60
    }
  ],
  "calendarLinks": {
    "google": "https://calendar.google.com/...",
    "apple": "webcal://...",
    "outlook": "https://outlook.office.com/...",
    "yahoo": "https://calendar.yahoo.com/...",
    "ics": "https://api.tktchurch.com/v1/events/123/calendar.ics"
  },
  "tags": ["worship", "sunday-service"],
  "maxCapacity": 500,
  "requiresGeolocation": true,
  "geofenceRadius": 100,
  "createdByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "updatedByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z",
  "thumbnail": {
    "id": "789e0123-j45k-67l8-m901-234567890123",
    "url": "https://storage.tktchurch.com/thumbnails/event-123.jpg",
    "provider": "s3",
    "key": "thumbnails/event-123.jpg"
  }
}

Path Parameters

id
string
required
The unique identifier (UUID) of the event

Response

id
string
Unique identifier for the event (UUID)
title
string
Event title
description
string
Event description
startDate
string
Event start date and time (ISO 8601)
endDate
string
Event end date and time (ISO 8601)
timezone
string
Event timezone
location
object
Event location details
type
string
Event type (service, meeting, concert, workshop, conference, social, other)
status
string
Event status (scheduled, cancelled, postponed, rescheduled)
recurrence
object
Event recurrence details (if recurring)
reminders
array
Event reminders
attachments
array
Event attachments
Calendar integration links
tags
array
Event tags
maxCapacity
integer
Maximum number of attendees (if applicable)
requiresGeolocation
boolean
Whether geolocation is required for attendance
geofenceRadius
number
Geofence radius in meters (if applicable)
createdByUserId
string
ID of user who created the event
updatedByUserId
string
ID of user who last updated the event
createdAt
string
Creation timestamp (ISO 8601)
updatedAt
string
Last update timestamp (ISO 8601)
thumbnail
object
Event thumbnail image

Error Responses

error
object
Error details when the request fails
Common error cases:
  • 404 Not Found: Event with the specified ID does not exist
curl -X GET "https://api.tktchurch.com/v1/events/123e4567-e89b-12d3-a456-426614174000" \
  -H "Accept: application/json"
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Sunday Worship Service",
  "description": "Weekly Sunday worship service",
  "startDate": "2024-01-07T10:00:00Z",
  "endDate": "2024-01-07T12:00:00Z",
  "timezone": "America/New_York",
  "location": {
    "name": "Main Sanctuary",
    "address": "123 Church Street",
    "city": "New York",
    "state": "NY",
    "country": "USA",
    "postalCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.0060
    }
  },
  "type": "service",
  "status": "scheduled",
  "recurrence": {
    "frequency": "weekly",
    "interval": 1,
    "byDay": ["SU"]
  },
  "reminders": [
    {
      "type": "email",
      "minutes": 1440
    },
    {
      "type": "notification",
      "minutes": 60
    }
  ],
  "calendarLinks": {
    "google": "https://calendar.google.com/...",
    "apple": "webcal://...",
    "outlook": "https://outlook.office.com/...",
    "yahoo": "https://calendar.yahoo.com/...",
    "ics": "https://api.tktchurch.com/v1/events/123/calendar.ics"
  },
  "tags": ["worship", "sunday-service"],
  "maxCapacity": 500,
  "requiresGeolocation": true,
  "geofenceRadius": 100,
  "createdByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "updatedByUserId": "456e7890-f12g-34h5-i678-912345678901",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z",
  "thumbnail": {
    "id": "789e0123-j45k-67l8-m901-234567890123",
    "url": "https://storage.tktchurch.com/thumbnails/event-123.jpg",
    "provider": "s3",
    "key": "thumbnails/event-123.jpg"
  }
}