> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thefaithapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Audio Sermons

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

<ParamField header="X-API-Key" type="string" required>
  Your client API key from the dashboard (Settings page).
</ParamField>

<ParamField query="search" type="string">
  Search term to filter audio sermons.
</ParamField>

<ParamField query="page" type="number">
  Page number for pagination (default: 1).
</ParamField>

## Response fields

<ResponseField name="current_page" type="number">
  The current page of audio sermon results.
</ResponseField>

<ResponseField name="data" type="object[]" required>
  Audio media items available to the authenticated member's church.
</ResponseField>

<ResponseField name="data[].source" type="string">
  The resolved playback URL or external source reference for the audio item.
</ResponseField>

<ResponseField name="data[].cover_photo" type="string">
  The resolved cover image URL shown for the audio item.
</ResponseField>

<ResponseField name="data[].has_transcript" type="boolean">
  Whether this sermon has a published transcript available through `GET /v1/media/{mediaId}/transcript`.
</ResponseField>

<ResponseField name="per_page" type="number">
  The maximum number of audio items returned in this page.
</ResponseField>

<ResponseField name="total" type="number">
  The total number of matching audio items across all pages.
</ResponseField>

## Example response

```json theme={null}
{
  "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
}
```
