---
title: "Get Church Suggestions"
method: GET
path: "/api/churches/suggestions"
tags: ["churches"]
---

# Get Church Suggestions

`GET /api/churches/suggestions`

Get top 10 church suggestions matching the search query.
Splits query into words and matches each word against search_text.
Returns empty list if query is empty.

## Query parameters

- `q` string — Search query string
- `city` string, nullable — City to prioritize results from
- `state` string, nullable — State ISO code to prioritize results from

## Response `200`

Successful Response

- ChurchSuggestionsResponse
  - `success` boolean, required
  - `churches` ChurchResult[], required
    - `id` integer, required
    - `name` string, nullable
    - `address` string, nullable
    - `city` string, nullable
    - `zip` string, nullable
    - `state_iso` string, nullable
    - `state_name` string, nullable
    - `country_iso` string, nullable
    - `country_name` string, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `website` string, nullable
    - `rating` number, nullable
    - `google_user_ratings_total` integer, nullable
    - `google_formatted_address` string, nullable
    - `cached_photo_url` string, nullable
    - `user_count` integer
    - `mass_times` ChurchMassTime[], nullable
      - `title` string, nullable
      - `day_of_week` string, nullable
      - `start_time` string, nullable
      - `end_time` string, nullable
      - `timezone` string, nullable
      - `mass_url` string, nullable
    - `upcoming_events` ChurchUpcomingEvent[], nullable
      - `title` string, nullable
      - `date` string, nullable
      - `start_time` string, nullable
      - `end_time` string, nullable
      - `timezone` string, nullable
      - `location` string, nullable
      - `event_url` string, nullable
    - `donation_links` ChurchDonationLink[], nullable
      - `title` string, nullable
      - `donation_url` string, nullable
    - `denomination` string, nullable
    - `site_announcements` ChurchAnnouncement[], nullable
      - `title` string, nullable
      - `summary` string, nullable
      - `date` string, nullable
      - `url` string, nullable
      - `first_seen_at` string, nullable
  - `count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/usecreed/apis/creed-api.md) · [All operations](https://skmtc.net/usecreed/apis/creed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usecreed/creed-api/revisions/cb25d3fef898/schema)