> ## 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 Video Sermons

> Retrieve a paginated list of video sermons for the authenticated user's church. Supports optional search and pagination.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/videos
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/videos:
    get:
      tags:
        - Content
      summary: Get Video Sermons
      description: >-
        Retrieve a paginated list of video sermons for the authenticated user's
        church. Supports optional search and pagination.
      operationId: getVideos
      parameters:
        - name: search
          in: query
          description: Search term to filter video 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 video 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 video sermon objects.
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          description: Unique identifier for the video sermon.
                          example: 2
                        client_id:
                          type: integer
                          description: ID of the church/client this video belongs to.
                          example: 2
                        category_id:
                          type: integer
                          description: ID of the category for this video.
                          example: 2
                        title:
                          type: string
                          description: Title of the video sermon.
                          example: >-
                            A Man Works For His Wife's Father While She Spends
                            Time With Other Guys
                        description:
                          type: string
                          description: Description of the video sermon.
                          example: >-
                            Today we're reviewing the comedy-drama film from
                            2007...
                        source:
                          type: string
                          description: >-
                            Video source identifier. For YouTube videos, this is
                            the YouTube video ID. For uploaded videos, this may
                            be a file name or path.
                          example: AyWgmsUxXR8
                        duration:
                          type: string
                          description: Duration of the video in MM:SS format.
                          example: '22:01'
                        media_type:
                          type: string
                          description: |-
                            Type of video source. Possible values:
                            - `2`: Upload MP4 Video
                            - `3`: MP4 Video Link
                            - `4`: YouTube Video ID
                            - `5`: Vimeo Video ID
                            - `6`: Dailymotion Video ID
                            - `7`: MPD Video Link
                            - `8`: M3U8 Video Link
                          example: '4'
                          enum:
                            - '2'
                            - '3'
                            - '4'
                            - '5'
                            - '6'
                            - '7'
                            - '8'
                        deleted_at:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          description: >-
                            Timestamp when the video was deleted, or null if not
                            deleted.
                          example: null
                        created_at:
                          type: string
                          format: date-time
                          description: Timestamp when the video was created.
                          example: '2025-02-08T12:58:14.000000Z'
                        updated_at:
                          type: string
                          format: date-time
                          description: Timestamp when the video was last updated.
                          example: '2025-02-08T12:58:14.000000Z'
                        cover_photo:
                          type: string
                          format: uri
                          description: URL to the cover photo image for the video.
                          example: >-
                            https://d2c58p2vdu8kb2.cloudfront.net/cover_photo/BbC3mhHtM7n1znGLGxnqWh4LzQIWCrFo2uyWKW2u.jpg
                  first_page_url:
                    type: string
                    format: uri
                    description: URL to the first page of results.
                    example: https://api.thefaithapp.com/v1/videos?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/videos?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: '&laquo; 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/videos
                  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: 2
                        client_id: 2
                        category_id: 2
                        title: >-
                          A Man Works For His Wife's Father While She Spends
                          Time With Other Guys
                        description: >-
                          Today we're reviewing the comedy-drama film from 2007.
                          Get ready for incredible plot twists!

                          A man marries a rich woman and works for her father.
                          At the same time, his wife has a habit of inviting
                          strangers to visit to get to know them better, which
                          her husband does not know about.
                        source: AyWgmsUxXR8
                        duration: '22:01'
                        media_type: '4'
                        deleted_at: null
                        created_at: '2025-02-08T12:58:14.000000Z'
                        updated_at: '2025-02-08T12:58:14.000000Z'
                        cover_photo: >-
                          https://d2c58p2vdu8kb2.cloudfront.net/cover_photo/BbC3mhHtM7n1znGLGxnqWh4LzQIWCrFo2uyWKW2u.jpg
                    first_page_url: https://api.thefaithapp.com/v1/videos?page=1
                    from: 1
                    last_page: 1
                    last_page_url: https://api.thefaithapp.com/v1/videos?page=1
                    links:
                      - url: null
                        label: '&laquo; Previous'
                        active: false
                      - url: https://api.thefaithapp.com/v1/videos?page=1
                        label: '1'
                        active: true
                      - url: null
                        label: Next &raquo;
                        active: false
                    next_page_url: null
                    path: https://api.thefaithapp.com/v1/videos
                    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`.

````