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 |
| 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) |