Global.Church Church API

Churches

Endpoint:https://global-church-main-ba4d06e.zuplo.app

Search churches (V1)

GET

https://global-church-main-ba4d06e.zuplo.app

/v1/churches/search

Proxies to the Supabase Edge Function churches-search. Supports free-text, exact filters, viewport (bbox) and radius queries, arrays for languages/programs, optional field projection, and GeoJSON output. Last updated: 2025-09-04.

Search churches (V1) › query Parameters

qstring
Free-text search across name/address/website (ranked). Only include this field if the user has explicitly requested it
countrystring · minLength: 3 · maxLength: 3
Country code (ISO 3166-1 alpha-3). Example: USA, NGA, GBR.
beliefstring · enum
Top-level belief family. AGENT INSTRUCTION:Only include this field if the user has explicitly requested it.
Enum values:
roman_catholic
protestant
orthodox
anglican
other
unknown
trinitarianboolean
Filter by Trinitarian belief. Currently redundant since we only support Trinitarian churches. AGENT INSTRUCTION: Never include this field.
regionstring · minLength: 2 · maxLength: 32
State/province/region code (e.g., US state). Most non-US regions are not supported. Use with caution. AGENT INSTRUCTION: You should almost never include this field.
localitystring
City/locality/town name.
postal_codestring
Postal/ZIP code prefix (prefix match).
languagesstring[] · minItems: 1 · style: form · explode: true
Service languages (array) using ISO 639-3 language codes. Encoded as repeated keys (e.g., ?languages=eng&languages=spa). Only include this parameter if the user has explicitly requested it.
programsstring[] · minItems: 1 · style: form · explode: true
Programs/ministries offered (array). Partial/ILIKE match per token. Only include this parameter if the user has explicitly requested it.
limitinteger · min: 1 · max: 10000
Max results to return. AGENT INSTRUCTION: Default 20.
idstring · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…
Filter by Global.Church's church_id field. UUIDv5 format. AGENT INSTRUCTION: You should almost never include this parameter.
min_latnumber · min: -90 · max: 90
Minimum latitude in decimal degrees.
max_latnumber · min: -90 · max: 90
Maximum latitude in decimal degrees.
min_lngnumber · min: -180 · max: 180
Minimum longitude in decimal degrees.
max_lngnumber · min: -180 · max: 180
Maximum longitude in decimal degrees.
center_latnumber · min: -90 · max: 90
Center latitude in decimal degrees.
center_lngnumber · min: -180 · max: 180
Center longitude in decimal degrees.
radius_kmnumber · min: 0.1 · max: 200
Search radius in kilometers.
fieldsstring
Comma-separated list of columns to include. Columns map to api.v1_churches.
formatstring · enum
Response format. json returns { items: [...] }. geojson returns a FeatureCollection.
Enum values:
json
geojson

Search churches (V1) › Headers

Authorizationstring · required
The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search churches (V1) › Responses

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · requires: items
	type = object · requires: type, features

Properties for Variant 1:

itemsobject[] · required

Get church by ID (V1)

GET

https://global-church-main-ba4d06e.zuplo.app

/v1/churches/{id}

Proxies to the Supabase Edge Function churches-get. Always returns the full record for a single church. This endpoint is intended to be used after a list/search so clients can fetch complete details (e.g., belief and livestream links) without managing field projections.

Get church by ID (V1) › path Parameters

idstring · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required
Global.Church church_id (UUIDv5).

Get church by ID (V1) › Headers

Authorizationstring · required
The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get church by ID (V1) › Responses

church_idstring · uuid
gers_idstring · uuid
namestring
pipeline_statusstring
latitudenumber
longitudenumber
addressstring
localitystring
regionstring
postal_codestring
countrystring
websitestring
logo_urlstring
logo_widthinteger
logo_heightinteger
logo_aspect_rationumber
banner_urlstring
banner_widthinteger
banner_heightinteger
banner_aspect_rationumber
phonestring
created_atstring · date-time
updated_atstring · date-time
url_givingstring
url_beliefsstring
url_youtubestring
url_facebookstring
url_instagramstring
url_tiktokstring
url_campusstring
url_livestring
contact_emailsstring[]
contact_phonesstring[]
service_timesinteger[]
service_languagesstring[]
service_source_urlsstring[]
ministry_namesstring[]
ministries_jsonobject
belief_typestring
denominationstring
trinitarianboolean
extraction_confidencenumber
church_summarystring
is_weekly_churchboolean
campus_namestring
overarching_namestring
is_multi_campusboolean
distance_mnumber