Skip to main content
GET
/
v1
/
media
/
{mediaId}
/
chapters
Get Sermon Chapters
curl --request GET \
  --url https://api.thefaithapp.com/v1/media/{mediaId}/chapters \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <x-api-key>'
{
  "status": "<string>",
  "data": {},
  "data.media_id": 123,
  "data.chapters": [
    {}
  ],
  "data.chapters[].start_ms": 123,
  "data.chapters[].title": "<string>"
}
Returns the published chapter markers for a sermon in the authenticated member’s church. If no chapter list is published, the response succeeds with data: null.

​
Request inputs

​
X-API-Key
string
required
Your client API key from the dashboard (Settings page).
​
mediaId
number
required
Unique identifier of the audio or video sermon.

​
Response fields

​
status
string
required
Indicates whether the chapter lookup succeeded.
​
data
object | null
Published chapter data, or null when no published chapters are available.
​
data.media_id
number
The media item these chapters belong to.
​
data.chapters
object[]
Ordered chapter markers.
​
data.chapters[].start_ms
number
Chapter start time in milliseconds.
​
data.chapters[].title
string
Chapter title shown in the player.

​
Example response

{
  "status": "Success",
  "data": {
    "media_id": 30,
    "chapters": [
      {
        "start_ms": 0,
        "title": "Welcome"
      },
      {
        "start_ms": 180000,
        "title": "Scripture reading"
      }
    ]
  }
}