Skip to main content
GET
/
v1
/
bulletins
Get Bulletins
curl --request GET \
  --url https://api.thefaithapp.com/v1/bulletins \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <x-api-key>'
{
  "current_page": 123,
  "data": [
    {}
  ],
  "data[].type": "<string>",
  "data[].sections": [
    {}
  ],
  "per_page": 123,
  "total": 123
}
Retrieves a paginated list of bulletins for the authenticated user’s church.
  • Requires both an API key and a TheFaithApp member bearer token.
  • Supports optional pagination.
  • Bulletins can be either native (HTML content) or PDF files.
  • Each bulletin may contain sections with different content types (text, links, images).

​
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 published bulletins.
​
data
object[]
required
The paginated list of published bulletins for the member’s church.
​
data[].type
string
The bulletin format, typically pdf or a native content entry.
​
data[].sections
object[]
Processed bulletin sections that the client can render when the bulletin is not PDF-only.
​
per_page
number
The maximum number of bulletins returned in this page.
​
total
number
The total number of published bulletins available for the church.

​
Example response

{
  "current_page": 1,
  "data": [
    {
      "id": 14,
      "title": "June Bulletin",
      "type": "pdf",
      "content": "",
      "pdf_url": "https://cdn.example.com/bulletins/june-bulletin.pdf",
      "sections": [],
      "published_at": "2025-06-30 16:12:17",
      "formatted_date": "Jun 30, 2025 4:12 PM"
    }
  ],
  "per_page": 10,
  "total": 1
}