> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thefaithapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Events

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

<ParamField header="X-API-Key" type="string" required>
  Your client API key from the dashboard (Settings page).
</ParamField>

<ParamField query="page" type="number">
  Page number for pagination (default: 1).
</ParamField>

## Response fields

<ResponseField name="current_page" type="number">
  The current page of upcoming events.
</ResponseField>

<ResponseField name="data" type="object[]" required>
  Upcoming event records available to the authenticated member's church.
</ResponseField>

<ResponseField name="data[].requires_registration" type="boolean">
  Indicates whether the client should present a registration flow for this event.
</ResponseField>

<ResponseField name="data[].registration_count" type="number">
  The number of registrations currently counted for this event.
</ResponseField>

<ResponseField name="data[].remaining_slots" type="number">
  Remaining registration capacity when the event uses capped built-in registration.
</ResponseField>

<ResponseField name="per_page" type="number">
  The maximum number of event records returned in this page.
</ResponseField>

<ResponseField name="total" type="number">
  The total number of upcoming events available for the church.
</ResponseField>

## Example response

```json theme={null}
{
  "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`.