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

GET

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

Client API key copied from Developer Access in the TheFaithApp dashboard.

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

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

Get Audio Sermons Get Single Devotional

Get Started

Endpoints

Authorizations

Headers

Query Parameters

Response