> ## 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. Supports optional search and pagination. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/audios openapi: 3.1.0 info: title: TheFaithApp Partner API version: 1.0.0 description: >- The v1 API for third-party apps that sign in TheFaithApp members and access church-scoped content and workflows. contact: name: TheFaithApp Support email: support@thefaithapp.com servers: - url: https://api.thefaithapp.com description: Production security: - apiKeyAuth: [] bearerAuth: [] tags: - name: Hosted Auth description: Sign members in through the hosted TheFaithApp authentication flow. - name: Core Experience description: Load member context and the personalized home experience. - name: Content description: >- Read sermons, media, YouTube videos, devotionals, and streaming configuration. - name: Engagement description: Manage member favorites and devotional bookmarks. - name: Churches description: Read church profiles, public directory records, and branch information. - name: Events & Volunteers description: >- Browse events and volunteer opportunities, then manage registrations and commitments. - name: Notifications & Bulletins description: Read church and member notifications and published bulletins. - name: Prayer description: Submit a prayer request for the authenticated member. - name: Member Connections description: Manage the member’s campus and ministry connections. - name: Community Groups description: >- Discover groups and manage membership, feeds, attendance, study guides, and leader notes. - name: Community Preferences & Research description: >- Manage community preferences, summaries, and consent-based research participation. - name: Resource Sharing description: Offer shared resources and manage member loan requests and transitions. - name: Mutual Aid description: >- Manage needs and offers, private responses, safety reports, and member activity. - name: Analytics description: Record product analytics events and retrieve aggregate metrics. - name: Notification Analytics description: Record and summarize notification delivery, open, and click events. paths: /v1/audios: get: tags: - Content summary: Get Audio Sermons description: >- Retrieve a paginated list of audio sermons for the authenticated user's church. Supports optional search and pagination. operationId: getAudios parameters: - name: search in: query description: Search term to filter audio sermons. required: false schema: type: string - name: page in: query description: 'Page number for pagination (default: 1).' required: false schema: type: integer default: 1 responses: '200': description: Paginated list of audio sermons. content: application/json: schema: type: object properties: current_page: type: integer description: Current page number of the result set. example: 1 data: type: array description: List of audio sermon objects. items: type: object properties: id: type: integer description: Unique identifier for the audio sermon. example: 6 client_id: type: integer description: ID of the church/client this audio belongs to. example: 2 category_id: type: integer description: ID of the category for this audio. example: 2 title: type: string description: Title of the audio sermon. example: Theme songs description: type: string description: Description of the audio sermon. example: Honour music source: type: string format: uri description: URL to the audio file or external audio link. example: >- https://d2c58p2vdu8kb2.cloudfront.net/audios/htE1gR0GTssLCZaVMKjTH6P1Q3w81dHz7KdyvVuJ.mp3 duration: type: string description: Duration of the audio in MM:SS format. example: '02:59' media_type: type: string description: >- Type of audio source. `0` = uploaded audio file, `1` = provided audio link. example: '0' enum: - '0' - '1' deleted_at: type: - string - 'null' format: date-time description: >- Timestamp when the audio was deleted, or null if not deleted. example: null created_at: type: string format: date-time description: Timestamp when the audio was created. example: '2025-02-08T13:15:52.000000Z' updated_at: type: string format: date-time description: Timestamp when the audio was last updated. example: '2025-02-08T13:15:52.000000Z' cover_photo: type: string format: uri description: URL to the cover photo image for the audio. example: >- https://d2c58p2vdu8kb2.cloudfront.net/cover_photo/XtzGozzqa6C8LIZ8RaAclJG7yO0Bj57JFlqTl3c2.jpg first_page_url: type: string format: uri description: URL to the first page of results. example: https://api.thefaithapp.com/v1/audios?page=1 from: type: integer description: Index of the first item returned. example: 1 last_page: type: integer description: Last page number of the result set. example: 1 last_page_url: type: string format: uri description: URL to the last page of results. example: https://api.thefaithapp.com/v1/audios?page=1 links: type: array description: Pagination navigation links. items: type: object properties: url: type: - string - 'null' format: uri description: URL for the page link, or null if not available. example: null label: type: string description: >- Label for the page link (e.g., 'Next', 'Previous', or page number). example: '« Previous' active: type: boolean description: Whether this page link is active. example: false next_page_url: type: - string - 'null' format: uri description: >- URL to the next page of results, or null if on the last page. example: null path: type: string format: uri description: Base path for the paginated results. example: https://api.thefaithapp.com/v1/audios per_page: type: integer description: Number of items per page. example: 30 prev_page_url: type: - string - 'null' format: uri description: >- URL to the previous page of results, or null if on the first page. example: null to: type: integer description: Index of the last item returned. example: 2 total: type: integer description: Total number of items available. example: 2 examples: success: summary: Successful response value: current_page: 1 data: - id: 6 client_id: 2 category_id: 2 title: Theme songs description: Honour music source: >- https://d2c58p2vdu8kb2.cloudfront.net/audios/htE1gR0GTssLCZaVMKjTH6P1Q3w81dHz7KdyvVuJ.mp3 duration: '02:59' media_type: '0' deleted_at: null created_at: '2025-02-08T13:15:52.000000Z' updated_at: '2025-02-08T13:15:52.000000Z' cover_photo: >- https://d2c58p2vdu8kb2.cloudfront.net/cover_photo/XtzGozzqa6C8LIZ8RaAclJG7yO0Bj57JFlqTl3c2.jpg first_page_url: https://api.thefaithapp.com/v1/audios?page=1 from: 1 last_page: 1 last_page_url: https://api.thefaithapp.com/v1/audios?page=1 links: - url: null label: '« Previous' active: false - url: https://api.thefaithapp.com/v1/audios?page=1 label: '1' active: true - url: null label: Next » active: false next_page_url: null path: https://api.thefaithapp.com/v1/audios per_page: 30 prev_page_url: null to: 2 total: 2 '401': description: Unauthorized - Missing or invalid API key or member bearer token. content: application/json: schema: type: object properties: error_message: type: string example: Unauthorized '404': description: User not found. content: application/json: schema: type: object properties: error: type: string example: User not found components: securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Client API key copied from Developer Access in the TheFaithApp dashboard. bearerAuth: type: http scheme: bearer bearerFormat: Sanctum description: Member access token returned by `POST /v1/auth/token`. ````