Global.Church Developer Portal
Global.Church API

Churches

Endpoint:https://api.global.church

Search organizations

GET
https://api.global.church
/v0/orgs/search

Search the Global.Church directory of organizations (churches, mission agencies, networks). Supports free-text, exact filters (country, region, locality, postal code, denomination, belief family), viewport (bbox) and radius queries, language and program arrays, optional field projection, and GeoJSON output.

Search organizations › 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. Values align with gc:BeliefTypeScheme (see ontology.global.church).

    Enum values:
    protestant
    catholic
    orthodox
    anglican
    independent
    marginal
    lds
    jw
  • 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 fields to include in each result. Field names match the Organization schema component.

  • formatstring · enum

    Response format. json returns { items: [...] }. geojson returns a FeatureCollection.

    Enum values:
    json
    geojson

Search organizations › 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 organizations › 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:
  • itemsobject[] · required
Organizations