> ## 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 > Retrieve a paginated list of events for the authenticated user's church. Supports optional pagination. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/events openapi: 3.1.0 info: title: TheFaithApp Partner API version: 1.0.0 description: >- The v1 API for third-party apps that sign in TheFaithApp members and access church-scoped content and workflows. contact: name: TheFaithApp Support email: support@thefaithapp.com servers: - url: https://api.thefaithapp.com description: Production security: - apiKeyAuth: [] bearerAuth: [] tags: - name: Hosted Auth description: Sign members in through the hosted TheFaithApp authentication flow. - name: Core Experience description: Load member context and the personalized home experience. - name: Content description: >- Read sermons, media, YouTube videos, devotionals, and streaming configuration. - name: Engagement description: Manage member favorites and devotional bookmarks. - name: Churches description: Read church profiles, public directory records, and branch information. - name: Events & Volunteers description: >- Browse events and volunteer opportunities, then manage registrations and commitments. - name: Notifications & Bulletins description: Read church and member notifications and published bulletins. - name: Prayer description: Submit a prayer request for the authenticated member. - name: Member Connections description: Manage the member’s campus and ministry connections. - name: Community Groups description: >- Discover groups and manage membership, feeds, attendance, study guides, and leader notes. - name: Community Preferences & Research description: >- Manage community preferences, summaries, and consent-based research participation. - name: Resource Sharing description: Offer shared resources and manage member loan requests and transitions. - name: Mutual Aid description: >- Manage needs and offers, private responses, safety reports, and member activity. - name: Analytics description: Record product analytics events and retrieve aggregate metrics. - name: Notification Analytics description: Record and summarize notification delivery, open, and click events. paths: /v1/events: get: tags: - Events & Volunteers summary: Get Events description: >- Retrieve a paginated list of events for the authenticated user's church. Supports optional pagination. operationId: getEvents parameters: - name: page in: query description: 'Page number for pagination (default: 1).' required: false schema: type: integer default: 1 responses: '200': description: Paginated list of events. content: application/json: schema: type: object properties: current_page: type: integer description: Current page number of the result set. example: 1 data: type: array description: List of event objects. items: type: object properties: id: type: integer description: Unique identifier for the event. example: 4 deleted_at: type: - string - 'null' format: date-time description: >- Timestamp when the event was deleted, or null if not deleted. example: null client_id: type: integer description: ID of the church/client this event belongs to. example: 2 title: type: string description: Title of the event. example: Kingdom Impartation thumbnail: type: string format: uri description: URL to the event's thumbnail image. example: >- https://d2c58p2vdu8kb2.cloudfront.net/events/WbYWMPFRYnKfCyYlReLjrKRyrP6SkTmGY6KhYBI9.png details: type: string description: >- Details or description of the event (may contain HTML). example:
date: type: string format: date-time description: Start date of the event. example: '2025-04-17T00:00:00.000000Z' time: type: string format: date-time description: Start time of the event. example: '2025-05-24T09:19:00.000000Z' created_at: type: string format: date-time description: Timestamp when the event was created. example: '2025-03-23T18:20:02.000000Z' updated_at: type: string format: date-time description: Timestamp when the event was last updated. example: '2025-03-23T18:20:02.000000Z' is_recurring: type: boolean description: Indicates whether the event is recurring. example: false recurrence_pattern: type: - string - 'null' description: >- Pattern of recurrence (e.g., 'weekly', 'monthly', 'yearly'). Null if not recurring. example: weekly recurrence_end_date: type: - string - 'null' format: date-time description: >- End date for recurring events. Null if no end date specified. example: null is_multi_day: type: boolean description: Indicates whether the event spans multiple days. example: false end_date: type: - string - 'null' format: date-time description: >- End date for multi-day events. Null if not a multi-day event. example: null end_time: type: - string - 'null' format: date-time description: >- End time for multi-day events. Null if not a multi-day event. example: null sort_date: type: string format: date-time description: >- Date used for sorting events (next occurrence for recurring events). example: '2025-04-17T00:00:00.000000Z' recurrence: type: - object - 'null' description: >- Recurrence information for recurring events. Null if not recurring. properties: pattern: type: string description: >- Pattern of recurrence (e.g., 'weekly', 'monthly', 'yearly'). example: weekly end_date: type: - string - 'null' format: date-time description: >- End date for the recurrence. Null if no end date specified. example: null next_occurrence: type: string format: date description: Next occurrence date for the recurring event. example: '2025-05-31' first_page_url: type: string format: uri description: URL to the first page of results. example: https://api.thefaithapp.com/v1/events?page=1 from: type: integer description: Index of the first item returned. example: 1 last_page: type: integer description: Last page number of the result set. example: 1 last_page_url: type: string format: uri description: URL to the last page of results. example: https://api.thefaithapp.com/v1/events?page=1 links: type: array description: Pagination navigation links. items: type: object properties: url: type: - string - 'null' format: uri description: URL for the page link, or null if not available. example: null label: type: string description: >- Label for the page link (e.g., 'Next', 'Previous', or page number). example: '« Previous' active: type: boolean description: Whether this page link is active. example: false next_page_url: type: - string - 'null' format: uri description: >- URL to the next page of results, or null if on the last page. example: null path: type: string format: uri description: Base path for the paginated results. example: https://api.thefaithapp.com/v1/events per_page: type: integer description: Number of items per page. example: 10 prev_page_url: type: - string - 'null' format: uri description: >- URL to the previous page of results, or null if on the first page. example: null to: type: integer description: Index of the last item returned. example: 1 total: type: integer description: Total number of items available. example: 1 examples: success: summary: Successful response value: current_page: 1 data: - id: 4 deleted_at: null client_id: 2 title: Kingdom Impartation thumbnail: >- https://d2c58p2vdu8kb2.cloudfront.net/events/WbYWMPFRYnKfCyYlReLjrKRyrP6SkTmGY6KhYBI9.png details:
date: '2025-04-17T00:00:00.000000Z' time: '2025-05-24T09:19:00.000000Z' created_at: '2025-03-23T18:20:02.000000Z' updated_at: '2025-03-23T18:20:02.000000Z' is_recurring: false recurrence_pattern: null recurrence_end_date: null is_multi_day: false end_date: null end_time: null sort_date: '2025-04-17T00:00:00.000000Z' - id: 5 deleted_at: null client_id: 2 title: Daily Conference thumbnail: >- https://d2c58p2vdu8kb2.cloudfront.net/events/kNiHY3rZ6quJrvGgNSXIofVI5OqZKRXPfobNhwVn.jpg details:

Our weekly sunday service

date: '2025-05-03T00:00:00.000000Z' time: '2025-05-24T05:00:00.000000Z' created_at: '2025-05-24T12:43:14.000000Z' updated_at: '2025-05-24T12:43:14.000000Z' is_recurring: true recurrence_pattern: weekly recurrence_end_date: null is_multi_day: false end_date: null end_time: null recurrence: pattern: weekly end_date: null next_occurrence: '2025-05-31' sort_date: '2025-05-31' first_page_url: https://api.thefaithapp.com/v1/events?page=1 from: 1 last_page: 1 last_page_url: https://api.thefaithapp.com/v1/events?page=1 links: - url: null label: '« Previous' active: false - url: https://api.thefaithapp.com/v1/events?page=1 label: '1' active: true - url: null label: Next » active: false next_page_url: null path: https://api.thefaithapp.com/v1/events per_page: 10 prev_page_url: null to: 3 total: 3 '401': description: Unauthorized - Missing or invalid API key or member bearer token. content: application/json: schema: type: object properties: error_message: type: string example: Unauthorized '404': description: User or events not found. content: application/json: schema: type: object properties: error: type: string example: User not found components: securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Client API key copied from Developer Access in the TheFaithApp dashboard. bearerAuth: type: http scheme: bearer bearerFormat: Sanctum description: Member access token returned by `POST /v1/auth/token`. ````