Skip to main content
GET
/
v1
/
events
Get Events
curl --request GET \
  --url https://api.thefaithapp.com/v1/events \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <x-api-key>'
{
  "current_page": 123,
  "data": [
    {}
  ],
  "data[].requires_registration": true,
  "data[].registration_count": 123,
  "data[].remaining_slots": 123,
  "per_page": 123,
  "total": 123
}
Retrieves a paginated list of events for the authenticated user’s church.
  • Requires both an API key and a TheFaithApp member bearer token.
  • Supports optional pagination.

​
Request inputs

​
X-API-Key
string
required
Your client API key from the dashboard (Settings page).
​
page
number
Page number for pagination (default: 1).

​
Response fields

​
current_page
number
The current page of upcoming events.
​
data
object[]
required
Upcoming event records available to the authenticated member’s church.
​
data[].requires_registration
boolean
Indicates whether the client should present a registration flow for this event.
​
data[].registration_count
number
The number of registrations currently counted for this event.
​
data[].remaining_slots
number
Remaining registration capacity when the event uses capped built-in registration.
​
per_page
number
The maximum number of event records returned in this page.
​
total
number
The total number of upcoming events available for the church.

​
Example response

{
  "current_page": 1,
  "data": [
    {
      "id": 132,
      "client_id": 12,
      "title": "Sunday Service",
      "details": "Join us for worship and teaching.",
      "date": "2026-06-16 17:17:49",
      "time": "17:17:49",
      "thumbnail": "https://cdn.example.com/events/sunday-service.jpg",
      "location_name": "Main Sanctuary",
      "location_address": "123 Church Road, Kampala",
      "requires_registration": true,
      "registration_type": "built_in",
      "registration_count": 0,
      "remaining_slots": null,
      "registration_deadline": "2026-06-03 18:03:14",
      "sort_date": "2026-06-16 17:17:49"
    }
  ],
  "per_page": 10,
  "total": 1
}
Built-in registration is handled by POST /v1/events/{event}/register.