Skip to main content
GET
/
v1
/
devotionals
Get Devotionals
curl --request GET \
  --url https://api.thefaithapp.com/v1/devotionals \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <x-api-key>'
{
  "current_page": 123,
  "data": [
    {}
  ],
  "data[].occurrence_date": "<string>",
  "data[].is_recurring": 123,
  "per_page": 123,
  "total": 123
}
Retrieves a paginated list of devotionals for the authenticated user’s church.
  • Requires both an API key and a TheFaithApp member bearer token.
  • Supports optional search and pagination.

​
Optional headers

  • X-Client-Date: resolve devotionals for a specific date.
  • X-Client-Timezone: resolve recurrence using the user’s timezone.

​
Request inputs

​
X-API-Key
string
required
Your client API key from the dashboard (Settings page).
​
X-Client-Date
string
The date for which to retrieve the devotional (format: YYYY-MM-DD). If provided, returns a single devotional for that date with metadata. If not provided, returns a paginated list of devotionals.
​
X-Client-Timezone
string
The timezone to use for date calculations (e.g., ‘America/New_York’). Only used when X-Client-Date is provided. If not provided, uses UTC.
​
search
string
Search term to filter devotionals. Only used when X-Client-Date is not provided.
​
page
number
Page number for pagination (default: 1). Only used when X-Client-Date is not provided.

​
Response fields

​
current_page
number
The current page of the devotional cycle list.
​
data
object[]
required
Devotional entries returned for the active cycle or search query.
​
data[].occurrence_date
string
The date this devotional is being surfaced for, which can differ from its original authoring date for recurring items.
​
data[].is_recurring
number
Indicates whether the devotional participates in the recurring devotional engine.
​
per_page
number
The maximum number of devotionals returned in this page.
​
total
number
The total number of devotionals available for the current filter.

​
Example response

{
  "current_page": 1,
  "data": [
    {
      "id": 21,
      "client_id": 12,
      "date": "2025-02-26",
      "occurrence_date": "2026-02-26",
      "author": "Dr Mike Okonkwo MFR",
      "title": "Where Does Your Hope Lie?",
      "bible_reading": "<p>Judges 15:17...</p>",
      "content": "<p>When Samson had finished using the uncommon weapon...</p>",
      "confession": "<p><strong>CONFESSION</strong></p>",
      "studies": "<p>Further Reading: Judges 15:17-20...</p>",
      "thumbnail": "https://cdn.example.com/devotionals/where-does-your-hope-lie.png",
      "tags": "[\"hope\"]",
      "is_recurring": 1,
      "recurrence_end_date": null,
      "version": 1,
      "original_id": null
    }
  ],
  "per_page": 30,
  "total": 1
}