Global.Church Developer Portal
Global.Church API

Churches

Endpoint:https://api.global.church

Search churches (V0)

GET
https://api.global.church
/v0/orgs/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 (V0) › 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.

    Enum values:
    roman_catholic
    protestant
    orthodox
    anglican
    other
    unknown
  • trinitarianboolean

    Filter by Trinitarian belief. Currently redundant since we only support Trinitarian churches.

  • regionstring · minLength: 2 · maxLength: 32

    State/province/region code (e.g., US state). Most non-US regions are not supported. Use with caution.

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

  • idstring · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

    Filter by Global.Church's church_id field. UUIDv5 format.

  • 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 (V0) › 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 (V0) › Responses

OK

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object · requires: items
type = object · requires: type, features
Properties for Variant 1:
  • itemsarray · required
Organizations