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>'
{
  "devotional": {
    "id": 1,
    "client_id": 2,
    "thumbnail": "devotionals/NIh2IeZv2g1k4AoNVhkoQarVWAkSAAnQLrr4DF7j.jpg",
    "title": "We're Not Mere Humans",
    "author": "Chris Parker",
    "content": "<div class=\"wp-block-media-text alignwide\">...</div>",
    "bible_reading": "<p><strong><em>These things have I written unto you...</em></strong></p>",
    "confession": "<p><strong>CONFESSION</strong></p>...",
    "studies": "<p><strong>FURTHER STUDY:</strong></p>...",
    "date": "2025-05-03T00:00:00.000000Z",
    "created_at": "2025-05-03T06:04:22.000000Z",
    "updated_at": "2025-05-03T06:07:05.000000Z",
    "deleted_at": null,
    "tags": [
      "prayer"
    ],
    "is_recurring": false,
    "recurrence_end_date": null,
    "version": 1,
    "original_id": null
  },
  "metadata": {
    "is_recurring": false,
    "next_available_date": null,
    "has_past_devotionals": false
  },
  "navigation": {
    "previous_date": "2024-05-02",
    "next_date": "2024-05-04"
  }
}
Retrieves a paginated list of devotionals for the authenticated user’s church.
  • Requires both an API key and a Firebase ID token.
  • Supports optional search and pagination.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-API-Key
string
required

Your client API key from the dashboard (Settings page).

​
X-Client-Date
string<date>

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.

Query Parameters

​
search
string

Search term to filter devotionals. Only used when X-Client-Date is not provided.

​
page
integer
default:1

Page number for pagination (default: 1). Only used when X-Client-Date is not provided.

Response

Devotional information. Returns either a single devotional with metadata when X-Client-Date is provided, or a paginated list of devotionals when no date is specified.

​
devotional
any
​
metadata
object

Additional information about the devotional and its context

​
navigation
object

Navigation links for moving between dates