> ## 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.

# List Churches

> Browse the public church directory with optional search and pagination.

Returns the paginated public church directory that third-party apps can browse.

## Query parameters

* `search`: optional text filter.
* `page`: optional page number.
* `per_page`: optional page size.

## 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">
  Optional text search filter.
</ParamField>

<ParamField query="page" type="number">
  Page number for pagination.
</ParamField>

<ParamField query="per_page" type="number">
  Number of records to return per page.
</ParamField>

## Response fields

<ResponseField name="current_page" type="number">
  The current page of the public church directory.
</ResponseField>

<ResponseField name="data" type="object[]" required>
  The paginated church records that matched the current filter.
</ResponseField>

<ResponseField name="data[].public_uuid" type="string">
  The public church identifier you can pass into `GET /v1/churches/public/{uuid}`.
</ResponseField>

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

<ResponseField name="total" type="number">
  The total number of matching churches across the full directory.
</ResponseField>

## Example response

```json theme={null}
{
  "current_page": 1,
  "data": [
    {
      "id": 12,
      "name": "Example Church",
      "email": "info@examplechurch.com",
      "location": "Kampala, Uganda",
      "image": "https://cdn.example.com/clients/example.png",
      "about": "<p>A welcoming church community.</p>",
      "public_uuid": "11111111-2222-3333-4444-555555555555",
      "created_at": "2025-04-11T08:40:54.000000Z",
      "updated_at": "2026-05-27T17:50:32.000000Z"
    }
  ],
  "first_page_url": "https://api.thefaithapp.com/v1/churches?page=1",
  "last_page": 1,
  "per_page": 30,
  "total": 1
}
```