---
title: "Search churches and parishes by name"
method: GET
path: "/churches/search"
tags: ["Churches"]
---

# Search churches and parishes by name

`GET /churches/search`

## Request

- Base URL: `https://api.holydb.com/v1`
- URL: `https://api.holydb.com/v1/churches/search`
- Auth: none declared

## Query parameters

- `q` string, required
- `lat` string: Optional origin; when given, ranks by distance within each match tier.
- `lng` string

## Response `200`

Matching churches, best match first

- ChurchSearchResult[]
  - `id` number, required
  - `name` string, required
  - `parishId` string, required
  - `parishName` string, required
  - `lat` number, required
  - `lng` number, required
  - `nextMass` Occurrence, nullable, required
    - `day` string, required
    - `time` string, required
    - `notes` string, nullable, required
  - `nextConfession` Occurrence, nullable, required
    - `day` string, required
    - `time` string, required
    - `notes` string, nullable, required

## Other responses

- `400`: Missing q

---

[API](https://skmtc.dev/holydb/apis/holydb-api.md) · [All operations](https://skmtc.dev/holydb/apis/holydb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/holydb/apis/holydb-api/revisions/7b5ce0171598?raw)