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
​
calendarLinks
object
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"
  }
}