Get Devotionals - TheFaithApp Documentation

Get Devotionals

curl --request GET \
  --url https://api.thefaithapp.com/v1/devotionals \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <api-key>'

const options = {
  method: 'GET',
  headers: {'X-API-Key': '<api-key>', Authorization: 'Bearer <token>'}
};

fetch('https://api.thefaithapp.com/v1/devotionals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.thefaithapp.com/v1/devotionals"

headers = {
    "X-API-Key": "<api-key>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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"
  }
}

GET

/

v1

/

devotionals

Get Devotionals

curl --request GET \
  --url https://api.thefaithapp.com/v1/devotionals \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <api-key>'

const options = {
  method: 'GET',
  headers: {'X-API-Key': '<api-key>', Authorization: 'Bearer <token>'}
};

fetch('https://api.thefaithapp.com/v1/devotionals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.thefaithapp.com/v1/devotionals"

headers = {
    "X-API-Key": "<api-key>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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"
  }
}

Authorizations

X-API-Key

string

header

required

Public client key copied from Developer Access. The member bearer token authenticates the request.

Authorization

string

header

required

Member access token returned by POST /v1/auth/token.

Headers

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.

Option 1
Option 2

devotional

object

Show child attributes

metadata

object

Additional information about the devotional and its context

Show child attributes

Navigation links for moving between dates

Show child attributes