Skip to main content
GET
/
v1
/
home
Get Home Feed
curl --request GET \
  --url https://api.thefaithapp.com/v1/home \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <x-api-key>'
{
  "status": "<string>",
  "data": {},
  "data.events": [
    {}
  ],
  "data.audios": [
    {}
  ],
  "data.videos": [
    {}
  ],
  "data.devotionals": [
    {}
  ],
  "data.bulletin": {},
  "data.church": {}
}

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.

Loads the main home payload for the authenticated member, including featured content, the latest bulletin, and church summary data.

​
Optional headers

  • X-Client-Timezone: use the member’s current timezone when resolving time-sensitive content.

​
Request inputs

​
X-API-Key
string
required
Your client API key from the dashboard (Settings page).
​
X-Client-Timezone
string
Optional IANA timezone identifier supplied by the client.

​
Response fields

​
status
string
required
Indicates whether the home feed was assembled successfully.
​
data
object
required
The complete home-screen payload for the signed-in member.
​
data.events
object[]
Upcoming church events selected for the home experience.
​
data.audios
object[]
Recently published audio sermons for this church.
​
data.videos
object[]
Recently published video sermons or linked video media.
​
data.devotionals
object[]
The current devotional items surfaced on the home screen.
​
data.bulletin
object
The latest published bulletin, when one exists for the church.
​
data.church
object
A lightweight church summary used for branding the home screen.

​
Example response

{
  "status": "Success",
  "data": {
    "events": [
      {
        "id": 88,
        "title": "Sunday Service",
        "date": "2026-06-02T09:00:00.000000Z"
      }
    ],
    "audios": [
      {
        "id": 30,
        "title": "Sample Prayer",
        "source": "https://cdn.example.com/audios/sample-prayer.mp3",
        "media_type": "0"
      }
    ],
    "videos": [
      {
        "id": 577,
        "title": "Prayer Evening",
        "source": "https://www.facebook.com/example/videos/123",
        "media_type": "9"
      }
    ],
    "devotionals": [
      {
        "id": 21,
        "title": "Where Does Your Hope Lie?",
        "occurrence_date": "2026-02-26"
      }
    ],
    "bulletin": {
      "id": 14,
      "title": "June Bulletin",
      "type": "pdf",
      "pdf_url": "https://cdn.example.com/bulletins/june-bulletin.pdf"
    },
    "church": {
      "id": 12,
      "name": "Example Church",
      "image": "https://cdn.example.com/clients/example.png"
    }
  }
}