Skip to main content
GET
/
v1
/
audios
Get Audio Sermons
curl --request GET \
  --url https://api.thefaithapp.com/v1/audios \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <x-api-key>'
{
  "current_page": 123,
  "data": [
    {}
  ],
  "data[].source": "<string>",
  "data[].cover_photo": "<string>",
  "data[].has_transcript": true,
  "per_page": 123,
  "total": 123
}
Retrieve a paginated list of audio sermons for the authenticated user’s church.

​
Query parameters

  • search: optional text filter.
  • page: optional page number.

​
Request inputs

​
X-API-Key
string
required
Your client API key from the dashboard (Settings page).
​
search
string
Search term to filter audio sermons.
​
page
number
Page number for pagination (default: 1).

​
Response fields

​
current_page
number
The current page of audio sermon results.
​
data
object[]
required
Audio media items available to the authenticated member’s church.
​
data[].source
string
The resolved playback URL or external source reference for the audio item.
​
data[].cover_photo
string
The resolved cover image URL shown for the audio item.
​
data[].has_transcript
boolean
Whether this sermon has a published transcript available through GET /v1/media/{mediaId}/transcript.
​
per_page
number
The maximum number of audio items returned in this page.
​
total
number
The total number of matching audio items across all pages.

​
Example response

{
  "current_page": 1,
  "data": [
    {
      "id": 30,
      "client_id": 12,
      "category_id": 2,
      "title": "Sample Prayer",
      "description": "A short prayer recording",
      "source": "https://cdn.example.com/audios/sample-prayer.mp3",
      "duration": "01:00",
      "media_type": "0",
      "cover_photo": "https://cdn.example.com/cover/sample-prayer.jpg",
      "has_transcript": true,
      "created_at": "2025-06-30T15:54:47.000000Z",
      "updated_at": "2025-06-30T15:54:47.000000Z"
    }
  ],
  "per_page": 10,
  "total": 1
}