Web Services

All eAdventist web services are RESTful and require an eAdventist account that has the appropriate role(s). To download data, submit a GET request via SSL (HTTPS) with email/password credentials in an "AUTHORIZATION" header. The email and password credentials should have a colon (:) separating them.Successful requests will receive a 200 response code and the data. Unsuccessful requests will receive an appropriate response code (e.g. 401 Unauthorized).

The AUTHORIZATION header now (as of July 23, 2024) supports both of the following formats:

AUTHORIZATION: username:password
AUTHORIZATION: Bearer username:password

NEW (15-Nov-2023) version 2 of Pastors service added - new format that includes both XML and JSON.

NEW (2-May-2023) the Hospitals service added.

DEPRECATED (16-Mar-2023), the Membership service will be replaced by lighter weight services.

NEW (7-Sept-2016), the "mask" parameter is now optional on all services. Omit it to get everything you have access to, include it to get specific data.

NEW (12-Oct-2017), the limit for each account is 4 requests/hour.

NEW (17-Oct-2017), organizations can upload higher-quality photos and they will be saved in 2 resolutions - "thumb" and "original". The URL to access photos has changed (e.g. www.eadventist.net/web_services/congregations/123/photo).

NEW (04-May-2021), Organization List service added.

Organization photos

Description Photo of an organization.
Available in 2 resolutions - "thumb" (160x120) and "original" (1024x768)
URL
https://www.eadventist.net/organizations/[organization_id]/photo
		
Output format Same as uploaded image. Allowed formats include JPEG/JPG, PNG, GIF
Required parameters none
Optional parameters style - "original" (up to 1024x768), "thumb" (160x120) , "original" is the default
Examples
.../organizations/2755/photo?style=thumb
		

Thumbnail-size photo of North American Division

Limit none

Congregations

Description Data specifically for churches, companies and groups.
Typically, all congregations are included (i.e. "public") except the conference church.
URL
https://www.eadventist.net/web_services/congregations
		

Test drive - requires an account

Output format XML (default), JSON
Required parameters none
Optional parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
orgtype - organization type (e.g. "6" for companies)
active - yes/no/all (default is "yes")
public - yes/no/all (default is "yes")
from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded 
Examples
.../web_services/congregations?mask=ANPP
		
- Southern California churches, companies and groups that are "active" and "public"

.../web_services/congregations?mask=ANPP&from=4%2F1%2F2014
		

- Southern California churches, companies and groups that are "active" and "public" and 
   have been updated on or since April 1, 2014

Limit 4 requests/hour (for each account)

Members Counts

Description Current member counts for churches and companies.
URL
https://www.eadventist.net/web_services/member_counts
		

Test drive - requires an account

Output format XML (default), JSON
Required parameters none
Optional parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
Examples
.../web_services/member_counts?mask=ANPP
		

- Southern California church and company member counts (current)

Limit 4 requests/hour (for each account)

Pastors

Description Names, email and mobile phone of pastors and assistant pastors. Using the from 
parameter will return empty records to indicate when pastors have been deleted. Omitting 
from returns a list of current pastors.
URL
https://www.eadventist.net/web_services/pastors
		

Test drive - requires an account

Output format version 2: XML & JSON, version 1: XML only
Required parameters none
Optional parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded 
sort - 1=by organization, 2=by person
v - version (version 2 new schema, both JSON and XML.
Examples
.../web_services/pastors?mask=ANPP&v=2
		

- Southern California pastors & assistant pastors

Limit 4 requests/hour (for each account)

Schools

Description You guessed it
URL
https://www.eadventist.net/web_services/schools
		

Test drive - requires an account

Output format XML (default), JSON
Required parameters none
Optional parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
orgtype - organization type (e.g. "6" for companies)
active - yes/no/all (default is "yes")
public - yes/no/all (default is "yes")
from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded 
Examples
.../web_services/schools?mask=ANPP
		

- Southern California schools ("active" & "public")

Limit 4 requests/hour (for each account)

Conferences

Description Conferences, unions, divisions and GC.
URL
https://www.eadventist.net/web_services/conferences
		

Test drive - requires an account

Output format XML
Required parameters none
Optional parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
orgtype - organization type (e.g. "6" for companies)
active - yes/no/all (default is "yes")
public - yes/no/all (default is "yes")
from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded 
Examples
.../web_services/conferences?mask=AN&orgtype=3
		

- All NAD conferences

Limit 4 requests/hour (for each account)

Hospitals

Description Hospitals, medical organizations
URL

https://eadventist.net/web_services/hospitals

Test drive - requires an account

Output format XML (default), JSON
Required parameters none
Optional parameters

mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)

orgtype - organization type (e.g. "6" for companies)

active - yes/no/all (default is "yes")

public - yes/no/all (default is "yes")

from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded 

Examples

.../web_services/hospitals?orgtype=27

All NAD hospitals

Limit 4 requests/hour (each account)

Locator organizations

Description Used by SDA Finder apps (iOS, Android).

Includes address, phone, email, web site, lat/long, pastor, service times for
all organizations changed or authorized since last update.
URL
https://www.eadventist.net/web_services/locator_organizations
		

Test drive - requires an account

Output format XML (default), JSON
Required parameters from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded
Optional parameters format - (xml/json) xml is default
Examples
.../web_services/locator_organizations?from=1234&format=json
		

- All organizations changed on or since 12/25/2014

Organizations

Description All organization data
URL
https://www.eadventist.net/web_services/organizations
		

Test drive - requires an account

Output format XML (default), JSON
Required parameters none
Optional parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
orgclass - organization class (e.g. "2" for congregations)
orgtype - organization type (e.g. "6" for companies)
active - yes/no/all (default is "yes")
public - yes/no/all (default is "yes")
from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded 
Examples
.../web_services/organizations?mask=ANP4&class=2
.../web_services/organizations.json?mask=ANF4&class=3
		
- Arizona congregations (i.e. churches, companies & groups)
.../web_services/organizations?mask=ANP4&class=3&changedfrom=12%2F25%2F2003
		

- Arizona schools changed from 12/25/2014 on

Limit 4 requests/hour (for each account)

Organizations ACTS

Description
Organizations (for ACTS software)
URL
https://www.eadventist.net/web_services/organizations_acts
		
Output format JSON
Required parameters mask - specifies the division/union/conference
Optional parameters orgclass - organization class (e.g. "2" for congregations)
orgtype - organization type (e.g. "6" for companies)
from - only changes from this datetime forward (e.g. "1/1/2021") HTML encoded
Examples
.../web_services/organizations_acts?mask=ANIF&from=1%2F1%2F2021
		

- All organizations in Oregon Conference that have changed since 1/1/2021

Limit 4 requests/hour

Organization List

Description Organization - OrgCode and Location
URL
https://www.eadventist.net/web_services/organization_list
		

Test drive - requires an account

Output format JSON (default), XML
Required parameters mask - specifies the division/union/conference
Optional parameters orgclass - organization class (e.g. "2" for congregations)
from - only changes from this datetime forward (e.g. "1/1/2021") HTML encoded
Examples
.../web_services/organization_list?mask=ANIF&from=1%2F1%2F2021
		

- All organizations in Oregon Conference that have changed since 1/1/2021

Limit 4 requests/hour

Public officers

Description Name & title of public officers (e.g. president, principal, pastor)

NOTE: If from parameter is present, notification will be included of officers
that have been deleted (e.g. pastor has moved and not been replaced yet)
URL
https://www.eadventist.net/web_services/public_officers
		

Test drive - requires an account

Output format XML (default), JSON
Required parameters none
Optional parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
orgclass - organization class (e.g. "2" for congregations)
orgtype - organization type (e.g. "6" for companies)
active - yes/no/all (default is "yes")
public - yes/no/all (default is "yes")
from - only changes from this datetime forward (e.g. "1/1/2014") HTML encoded 
Examples
.../web_services/organizations?mask=ANP4&class=2
		
- Arizona pastors(including associate, assistant, lay & intern)

.../web_services/organizations?mask=ANP4&class=3&changedfrom=12%2F25%2F2003
		

- Arizona principals & vice-principals changed from 12/25/2014 on

Limit 4 requests/hour (for each account)

Membership - deprecated 16-Mar-2023

Description Includes almost all eAdventist data for church/conf/union
URL
https://www.eadventist.net/web_services/membership
		

Test drive - requires an account

Output format Multiple CSV files compressed in a ZIP file
Required parameters mask - specifies the division/union/conference (e.g. "ANIF" for Oregon Conf)
Optional parameters v - version (version 2 includes officer preferences for address/phone/email)
NOTE: version 1 has been deprecated (March 2, 2015)
Examples
.../web_services/membership?mask=ANWF&v=2
		

- Texas membership data

Limit 4 requests/hour (for each account)

Still need help? Contact Us Contact Us