> ## 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 Latest Bulletin
> Retrieve the most recent bulletin for the authenticated user's church. Returns the latest published bulletin with all its content and sections.
## OpenAPI
````yaml /api-reference/openapi.json get /v1/bulletins/latest
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/latest:
get:
tags:
- Notifications & Bulletins
summary: Get Latest Bulletin
description: >-
Retrieve the most recent bulletin for the authenticated user's church.
Returns the latest published bulletin with all its content and sections.
operationId: getBulletinsLatest
responses:
'200':
description: Latest bulletin information.
content:
application/json:
schema:
type: object
properties:
bulletin:
type: object
description: The latest bulletin 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
examples:
success:
summary: Successful response
value:
bulletin:
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
'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 or no bulletins available.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: No bulletins 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`.
````