> ## 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 Bulletins
> Retrieve a paginated list of bulletins for the authenticated user's church. Bulletins can be either native (HTML content) or PDF files.
## OpenAPI
````yaml /api-reference/openapi.json get /v1/bulletins
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/bulletins:
get:
tags:
- Notifications & Bulletins
summary: Get Bulletins
description: >-
Retrieve a paginated list of bulletins for the authenticated user's
church. Bulletins can be either native (HTML content) or PDF files.
operationId: getBulletins
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 bulletins.
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 bulletin objects.
items:
type: object
properties:
id:
type: integer
description: Unique identifier for the bulletin.
example: 9
title:
type: string
description: Title of the bulletin.
example: 22 June 2025
type:
type: string
description: >-
Type of bulletin content. Can be 'native' (HTML
content) or 'pdf' (PDF file).
example: native
enum:
- native
- pdf
content:
type: string
description: >-
HTML content of the bulletin. Empty string for PDF
type bulletins.
example: >-
ποΈ Sunday Worship
Bulletin
pdf_url:
type:
- string
- 'null'
format: uri
description: >-
URL to the PDF file for PDF type bulletins. Null for
native type bulletins.
example: null
sections:
type: array
description: >-
Array of bulletin sections containing different
types of content.
items:
type: object
properties:
type:
type: string
description: >-
Type of section content. Can be 'text',
'link', or 'image'.
example: text
enum:
- text
- link
- image
title:
type: string
description: Title of the section.
example: 'π Theme of the Day:'
content:
type: string
description: >-
Content of the section. For 'text' type,
contains the text content. For 'link' type,
contains the URL. For 'image' type, contains
the image URL.
example: >-
"Walking by Faith"
2 Corinthians 5:7 β "For we walk by faith, not
by sight."
published_at:
type: string
format: date-time
description: Timestamp when the bulletin was published.
example: '2025-06-21 15:04:09'
formatted_date:
type: string
description: Human-readable formatted date of the bulletin.
example: June 21, 2025
first_page_url:
type: string
format: uri
description: URL to the first page of results.
example: https://api.thefaithapp.com/bulletins?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/bulletins?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/bulletins
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: 2
total:
type: integer
description: Total number of items available.
example: 2
examples:
success:
summary: Successful response
value:
current_page: 1
data:
- id: 9
title: 22 June 2025
type: native
content: >-
ποΈ Sunday Worship
Bulletin
pdf_url: null
sections:
- type: text
title: 'π Theme of the Day:'
content: >-
"Walking by Faith"
2 Corinthians 5:7 β "For we walk by faith, not by
sight."
- type: link
title: π Order of Service
content: https://www.youtube.com/watch?v=dMgr7nZ-eMA
- type: image
title: Gallery
content: >-
https://d2c58p2vdu8kb2.cloudfront.net/bulletins/sections/dzfRCxQ0Sinp9qkViUBrUs02EOWVMNwJfyFSvTR2.png
published_at: '2025-06-21 15:04:09'
formatted_date: June 21, 2025
- id: 8
title: 6 July 2025 (Copy)
type: pdf
content: ''
pdf_url: >-
https://d2c58p2vdu8kb2.cloudfront.net/bulletins/SKGWKlB3dtue59J2ZMK0cfcsN9p520El6HxgHIPN.pdf
sections: []
published_at: '2025-06-21 14:20:47'
formatted_date: June 21, 2025
first_page_url: https://api.thefaithapp.com/bulletins?page=1
from: 1
last_page: 1
last_page_url: https://api.thefaithapp.com/bulletins?page=1
links:
- url: null
label: '« Previous'
active: false
- url: https://api.thefaithapp.com/bulletins?page=1
label: '1'
active: true
- url: null
label: Next »
active: false
next_page_url: null
path: https://api.thefaithapp.com/bulletins
per_page: 10
prev_page_url: null
to: 2
total: 2
'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 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`.
````