ChMeetings

Get all campaigns from the ChMeetings API with pagination Scope: main church only — reads the church linked to the API key and cannot be narrowed to one ministry. Never present its numbers as a ministry figure.

get_campaigns

Get the cities of one state as { id, name }, optionally narrowed by search. Resolve state_id with get_states_by_country_id first. A city is narrower than a state: filtering people by city_id answers "who lives in this town", by state_id "who lives in this region". Ids come only from this chain - get_countries, then get_states_by_country_id, then get_cities_by_state_id - and feed the country_id, state_id and city_id filters of get_people. A name is never accepted where an id is asked for, and an id can never be guessed.

get_cities_by_state_id

Get all contribution batches from the ChMeetings API with pagination Scope: main church only — reads the church linked to the API key and cannot be narrowed to one ministry. Never present its numbers as a ministry figure.

get_contribution_batches

Get all contributions from the ChMeetings API with pagination and optional filtering by person_id, start_date, end_date, reference_id and batch_id Scope: main church only — reads the church linked to the API key and cannot be narrowed to one ministry. Never present its numbers as a ministry figure.

get_contributions

Get the countries reference list as { id, name }, optionally narrowed by search. This is the first step before filtering people by where they live. Ids come only from this chain - get_countries, then get_states_by_country_id, then get_cities_by_state_id - and feed the country_id, state_id and city_id filters of get_people. A name is never accepted where an id is asked for, and an id can never be guessed.

get_countries

Get event attendance statistics across a date range. Returns a per-occurrence attendance summary plus a period rollup for every materialized occurrence of the event with Day within [from, to]. Pass include=groups to add a per-group breakdown inside each occurrence. Pass the same church_or_ministry_id the event was listed under — an event id from one church or ministry is not found in another. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_event_statistics

Get events within a date range with pagination. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_events

Get a specific family by ID Scope: main church only — reads the church linked to the API key and cannot be narrowed to one ministry. Never present its numbers as a ministry figure.

get_family_by_id

Get the follow-up action categories (e.g. "First Visit") available to the church, unpaged and sorted by name. Use an action's id as the action_id filter of get_follow_ups. Each church and ministry has its own set of actions, so read them under the same church_or_ministry_id you will filter with. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_follow_up_actions

Get a single follow-up (pastoral follow-up task) by its ID, including its assignees, status, type, notes and completion details. Pass the same church_or_ministry_id the follow-up was listed under — an id from one church or ministry is not found in another. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_follow_up_by_id

Get follow-ups (pastoral follow-up tasks) with pagination and optional filters. A follow-up is a task to follow up with a specific person, optionally assigned to responsible people ("assignees") and categorized by a follow-up action. Filters combine with AND; omit a filter to leave it unapplied. To find follow-ups for a specific person, first resolve the person with get_people, then pass person_id. For overdue follow-ups use status=pending with to=<today>. Results are sorted by scheduled date descending. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_follow_ups

Get all groups from the ChMeetings API, optionally narrowed by name with search_text. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_groups

Retrieve all public notes for a specific person with paging Scope: main church only — reads the church linked to the API key and cannot be narrowed to one ministry. Never present its numbers as a ministry figure.

get_member_notes

Get all members who do not have an envelope number assigned. Scope: main church only — reads the church linked to the API key and cannot be narrowed to one ministry. Never present its numbers as a ministry figure.

get_no_envelope_members

Get the paginated attendance list for an occurrence. The occurrence_id may be a materialized (numeric) or virtual occurrence ID. Narrow the list by attendance status, by a single group with group_id, or to attendees in no group at all with ungrouped=true — group_id and ungrouped are mutually exclusive. Pass the same church_or_ministry_id the occurrence belongs to. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_occurrence_attendance

Get people from the ChMeetings API with paging and filters. Filters combine with AND; omit one to leave it unapplied. Filter server-side rather than paging through everyone and sifting: every page carries whole profiles. For a count, apply the filters and read `totalResults` - that is the match across all pages, while the rows returned are one page of it. Resolve ids first: get_groups for group_ids, and get_countries / get_states_by_country_id / get_cities_by_state_id for country_id, state_id and city_id. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_people

Get the people who belong to one or more groups, with the group each membership is in. Resolve the group ids with get_groups under the same scope first. group_ids is required and there is no all-groups mode: omitting it returns an "Invalid Group Ids" error rather than everyone. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_people_in_groups

Get a person by their ID. Scope: main church only — reads the church linked to the API key and cannot be narrowed to one ministry. Never present its numbers as a ministry figure.

get_person_by_id

Get the post categories - the topics posts are filed under, e.g. "Announcements", "Events". Use this to turn the category_ids on a post into names. Each church and ministry has its own categories, so read them under the same church_or_ministry_id you read the posts under. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_post_categories

Get the comments on a specific post, with the author of each. Find the post id with get_posts first. A post with allow_comments=false returns no comments. Pass the same church_or_ministry_id the post was listed under — a post id from one church or ministry is not found in another. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_post_comments

Get the likes on a specific post, with the person behind each one. Find the post id with get_posts first. A post with allow_likes=false returns no likes. Pass the same church_or_ministry_id the post was listed under — a post id from one church or ministry is not found in another. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_post_likes

Get the church posts (announcements and news published to the app feed), newest first. Filter by status (draft/published) and by a published_on date range. Each post carries likes_count and comments_count; use get_post_comments and get_post_likes to see who commented or liked. Categories come back as ids only - resolve their names with get_post_categories. Scope: omit church_or_ministry_id to read the main church linked to the API key, or pass an id from get_churches_and_ministries to read one church or ministry. The response echoes the scope it read as `scope` — report figures against that, not against the church the user assumed.

get_posts

Get the states (provinces, governorates) of one country as { id, name }, optionally narrowed by search. Resolve country_id with get_countries first. Ids come only from this chain - get_countries, then get_states_by_country_id, then get_cities_by_state_id - and feed the country_id, state_id and city_id filters of get_people. A name is never accepted where an id is asked for, and an id can never be guessed.

get_states_by_country_id

Get every church and ministry one person belongs to, with pagination. Main-church entries come first. Resolve the person with get_people first to get their person_id. Use this to answer "which ministries is X in?", and to pick the church_or_ministry_id for a scoped call about that person — it is narrower than get_churches_and_ministries when the question is already about one person. Never write "organization" or "organisation" to the user: call each one a church or a ministry, or use its own name.

get_person_churches_and_ministries