> ## 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 Devotionals

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

<ParamField header="X-API-Key" type="string" required>
  Your client API key from the dashboard (Settings page).
</ParamField>

<ParamField header="X-Client-Date" type="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.
</ParamField>

<ParamField header="X-Client-Timezone" type="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.
</ParamField>

<ParamField query="search" type="string">
  Search term to filter devotionals. Only used when X-Client-Date is not provided.
</ParamField>

<ParamField query="page" type="number">
  Page number for pagination (default: 1). Only used when X-Client-Date is not provided.
</ParamField>

## Response fields

<ResponseField name="current_page" type="number">
  The current page of the devotional cycle list.
</ResponseField>

<ResponseField name="data" type="object[]" required>
  Devotional entries returned for the active cycle or search query.
</ResponseField>

<ResponseField name="data[].occurrence_date" type="string">
  The date this devotional is being surfaced for, which can differ from its original authoring date for recurring items.
</ResponseField>

<ResponseField name="data[].is_recurring" type="number">
  Indicates whether the devotional participates in the recurring devotional engine.
</ResponseField>

<ResponseField name="per_page" type="number">
  The maximum number of devotionals returned in this page.
</ResponseField>

<ResponseField name="total" type="number">
  The total number of devotionals available for the current filter.
</ResponseField>

## Example response

```json theme={null}
{
  "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
}
```