> ## 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 Church Profile

> Returns the authenticated member’s church profile, social links, branches, gatherings, and hosted action URLs. Open `church.giving_link` for member giving.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/church
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/church:
    get:
      tags:
        - Churches
      summary: Get Church Profile
      description: >-
        Returns the authenticated member’s church profile, social links,
        branches, gatherings, and hosted action URLs. Open `church.giving_link`
        for member giving.
      operationId: getChurch
      responses:
        '200':
          description: Church profile information.
          content:
            application/json:
              schema:
                type: object
                properties:
                  church:
                    type: object
                    description: >-
                      Church profile and hosted action URLs. Use the hosted
                      links for flows that are not exposed as partner API
                      operations.
                    properties:
                      id:
                        type: integer
                        description: Unique identifier for the church.
                        example: 2
                      name:
                        type: string
                        description: Name of the church.
                        example: Monk House Maker
                      email:
                        type: string
                        description: Contact email for the church.
                        example: emilyjanemdn@gmail.com
                      location:
                        type: string
                        description: Physical address or location of the church.
                        example: 4078 Poco Mas Drive
                      image:
                        type: string
                        format: uri
                        description: URL to the church's image or logo.
                        example: >-
                          https://d2c58p2vdu8kb2.cloudfront.net/clients/wcwOY98v6H9Aq4ag8vOnDXMgGXfyZyIJmRyBguj9.jpg
                      created_at:
                        type: string
                        format: date-time
                        description: Timestamp when the church was created.
                        example: '2025-02-08T11:55:32.000000Z'
                      updated_at:
                        type: string
                        format: date-time
                        description: Timestamp when the church was last updated.
                        example: '2025-05-24T07:56:51.000000Z'
                      about:
                        type: string
                        description: About or description of the church (may contain HTML).
                        example: >-
                          <p data-start="86" data-end="423"><strong
                          data-start="86" data-end="109">Kingdom Life
                          Church</strong> is a Christ-centered community
                          passionate about worship, discipleship, and outreach.
                          Located in the heart of the city, we welcome people
                          from all walks of life to experience the love and
                          grace of God. Our mission is to raise up faithful
                          believers who impact their families, workplaces, and
                          communities for Christ.</p>

                          <p data-start="425" data-end="872">One of our core
                          ministries is the <strong data-start="459"
                          data-end="482">Compassion Ministry</strong>, which
                          focuses on serving the practical needs of those around
                          us. From monthly food drives and clothing donations to
                          visiting the sick and supporting single-parent homes,
                          this ministry is rooted in the belief that small acts
                          of kindness can lead to life-changing encounters with
                          God. Volunteers in this ministry are the hands and
                          feet of Jesus, spreading hope and love throughout the
                          city.</p>

                          <p data-start="874" data-end="1153">Whether you're
                          looking for a place to grow spiritually or a way to
                          make a difference, the Compassion Ministry offers a
                          meaningful way to serve. We invite anyone with a heart
                          to help others to join us as we continue to be a light
                          in our community, one act of compassion at a time.</p>
                      giving_link:
                        type: string
                        format: uri
                        description: >-
                          Hosted TheFaithApp giving page for this church. Open
                          this URL in a browser or in-app browser to continue
                          the member-giving flow.
                        example: >-
                          https://app.thefaithapp.com/give/11111111-2222-3333-4444-555555555555
                      prayer_request_link:
                        type: string
                        format: uri
                        description: URL for submitting prayer requests to the church.
                        example: https://app.thefaithapp.com/prayer-requests/2
                      socials:
                        type: object
                        description: Social media links for the church.
                        properties:
                          id:
                            type: integer
                            description: Unique identifier for the socials object.
                            example: 1
                          client_id:
                            type: integer
                            description: ID of the church/client.
                            example: 2
                          facebook:
                            type: string
                            description: Facebook page URL or handle.
                            example: www.facebook.com/monkhouse
                          instagram:
                            type: string
                            description: Instagram handle.
                            example: www.instagram.com/monk_house
                          twitter:
                            type: string
                            description: Twitter/X handle.
                            example: www.x.com/monkhouse_
                          youtube:
                            type: string
                            description: YouTube channel URL or handle.
                            example: www.youtube.com/@mkhouse
                          tiktok:
                            type: string
                            description: TikTok handle.
                            example: www.tiktok.com/@mk2000
                          deleted_at:
                            type:
                              - string
                              - 'null'
                            format: date-time
                            description: >-
                              Timestamp when the socials were deleted, or null
                              if not deleted.
                            example: null
                          created_at:
                            type: string
                            format: date-time
                            description: Timestamp when the socials were created.
                            example: '2025-05-03T06:31:31.000000Z'
                          updated_at:
                            type: string
                            format: date-time
                            description: Timestamp when the socials were last updated.
                            example: '2025-05-03T06:31:31.000000Z'
                      branches:
                        type: array
                        description: List of branch objects for the church.
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              description: Unique identifier for the branch.
                              example: 1
                            client_id:
                              type: integer
                              description: ID of the church/client.
                              example: 2
                            name:
                              type: string
                              description: Name of the branch.
                              example: Reno Branch
                            location:
                              type: string
                              description: Physical address of the branch.
                              example: 596 Sheila Lane Reno, NV 89501
                            pastor:
                              type: string
                              description: Name of the branch pastor.
                              example: Katelyn C. Warne
                            contact:
                              type: string
                              description: Contact phone number for the branch.
                              example: +1 775-370-2016
                            created_at:
                              type: string
                              format: date-time
                              description: Timestamp when the branch was created.
                              example: '2025-05-03T06:32:50.000000Z'
                            updated_at:
                              type: string
                              format: date-time
                              description: Timestamp when the branch was last updated.
                              example: '2025-05-03T06:32:50.000000Z'
                            deleted_at:
                              type:
                                - string
                                - 'null'
                              format: date-time
                              description: >-
                                Timestamp when the branch was deleted, or null
                                if not deleted.
                              example: null
                      gatherings:
                        type: array
                        description: List of gatherings/meetings for the church.
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              description: Unique identifier for the gathering.
                              example: 1
                            client_id:
                              type: integer
                              description: >-
                                ID of the church/client this gathering belongs
                                to.
                              example: 2
                            gathering_type_id:
                              type: integer
                              description: >-
                                ID of the gathering type. Possible values:

                                - `1`: Service - Regular worship services
                                including Sunday services, midweek services,
                                etc.

                                - `2`: Study - Bible study groups, Sunday
                                school, discipleship classes

                                - `3`: Prayer - Regular prayer gatherings,
                                prayer vigils

                                - `4`: Youth - Youth services, youth meetings,
                                youth activities

                                - `5`: Children - Children's church, Sunday
                                school, children's activities

                                - `6`: Food Pantry - Food distribution services,
                                community feeding programs

                                - `7`: Outreach - Community outreach, evangelism
                                programs

                                - `8`: Fellowship - Fellowship meals, social
                                gatherings, community events

                                - `9`: Choir - Choir rehearsals, music ministry
                                practices

                                - `10`: Counseling - Pastoral counseling,
                                support groups
                              example: 1
                            name:
                              type: string
                              description: Name of the gathering.
                              example: First Service
                            day_of_week:
                              type: string
                              description: Day of the week when the gathering occurs.
                              example: Sunday
                            start_time:
                              type: string
                              format: date-time
                              description: Start time of the gathering.
                              example: '2025-05-24T10:00:00.000000Z'
                            end_time:
                              type: string
                              format: date-time
                              description: End time of the gathering.
                              example: '2025-05-24T13:51:00.000000Z'
                            description:
                              type: string
                              description: Description of the gathering.
                              example: This is our first service
                            is_active:
                              type: boolean
                              description: Whether the gathering is currently active.
                              example: true
                            created_at:
                              type: string
                              format: date-time
                              description: Timestamp when the gathering was created.
                              example: '2025-05-24T07:51:09.000000Z'
                            updated_at:
                              type: string
                              format: date-time
                              description: Timestamp when the gathering was last updated.
                              example: '2025-05-24T08:26:30.000000Z'
                            deleted_at:
                              type:
                                - string
                                - 'null'
                              format: date-time
                              description: >-
                                Timestamp when the gathering was deleted, or
                                null if not deleted.
                              example: null
              examples:
                success:
                  summary: Successful response
                  value:
                    church:
                      id: 2
                      name: Monk House Maker
                      email: emilyjanemdn@gmail.com
                      location: 4078 Poco Mas Drive
                      image: >-
                        https://d2c58p2vdu8kb2.cloudfront.net/clients/wcwOY98v6H9Aq4ag8vOnDXMgGXfyZyIJmRyBguj9.jpg
                      created_at: '2025-02-08T11:55:32.000000Z'
                      updated_at: '2025-05-24T07:56:51.000000Z'
                      about: >-
                        <p data-start="86" data-end="423"><strong
                        data-start="86" data-end="109">Kingdom Life
                        Church</strong> is a Christ-centered community
                        passionate about worship, discipleship, and outreach.
                        Located in the heart of the city, we welcome people from
                        all walks of life to experience the love and grace of
                        God. Our mission is to raise up faithful believers who
                        impact their families, workplaces, and communities for
                        Christ.</p>

                        <p data-start="425" data-end="872">One of our core
                        ministries is the <strong data-start="459"
                        data-end="482">Compassion Ministry</strong>, which
                        focuses on serving the practical needs of those around
                        us. From monthly food drives and clothing donations to
                        visiting the sick and supporting single-parent homes,
                        this ministry is rooted in the belief that small acts of
                        kindness can lead to life-changing encounters with God.
                        Volunteers in this ministry are the hands and feet of
                        Jesus, spreading hope and love throughout the city.</p>

                        <p data-start="874" data-end="1153">Whether you're
                        looking for a place to grow spiritually or a way to make
                        a difference, the Compassion Ministry offers a
                        meaningful way to serve. We invite anyone with a heart
                        to help others to join us as we continue to be a light
                        in our community, one act of compassion at a time.</p>
                      giving_link: >-
                        https://app.thefaithapp.com/give/11111111-2222-3333-4444-555555555555
                      prayer_request_link: https://app.thefaithapp.com/prayer-requests/2
                      socials:
                        id: 1
                        client_id: 2
                        facebook: www.facebook.com/monkhouse
                        instagram: www.instagram.com/monk_house
                        twitter: www.x.com/monkhouse_
                        youtube: www.youtube.com/@mkhouse
                        tiktok: www.tiktok.com/@mk2000
                        deleted_at: null
                        created_at: '2025-05-03T06:31:31.000000Z'
                        updated_at: '2025-05-03T06:31:31.000000Z'
                      branches:
                        - id: 1
                          client_id: 2
                          name: Reno Branch
                          location: 596 Sheila Lane Reno, NV 89501
                          pastor: Katelyn C. Warne
                          contact: +1 775-370-2016
                          created_at: '2025-05-03T06:32:50.000000Z'
                          updated_at: '2025-05-03T06:32:50.000000Z'
                          deleted_at: null
                      gatherings:
                        - id: 1
                          client_id: 2
                          gathering_type_id: 1
                          name: First Service
                          day_of_week: Sunday
                          start_time: '2025-05-24T10:00:00.000000Z'
                          end_time: '2025-05-24T13:51:00.000000Z'
                          description: This is our first service
                          is_active: true
                          created_at: '2025-05-24T07:51:09.000000Z'
                          updated_at: '2025-05-24T08:26:30.000000Z'
                          deleted_at: null
        '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 or church not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Church 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`.

````