### Campus Profile Service Examples Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for the campus_profile service using cURL and XML. ```bash curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=campus_profile&id=1" ``` ```xml execute public Church of Cucumbers
Your Church Name Your Address City Your Address City
(555) 555-5555 All members of CC https://yourchurch.ccbchurch.com/group_detail.php?group_id=7 en_US America/Denver dollar 1 System User System User 2010-05-07 15:30:41
``` -------------------------------- ### Campus List Service Examples Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for the campus_list service using cURL and XML. ```bash curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=campus_list" ``` ```xml campus_list execute public Church of Cucumbers 1 System User System User 2010-05-07 15:30:41 Mountain 1 System User System User 2012-11-08 13:47:12 ``` -------------------------------- ### Community Login Service Examples Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for the individual_id_from_login_password service using cURL and XML. ```bash curl -u user:pass -d "login=myusername&password=mypassword" "https://yourchurch.ccbchurch.com/api.php?srv=individual_id_from_login_password" ``` ```xml 48 48 ``` -------------------------------- ### Get Individual Notes XML Response Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML response for retrieving individual notes. Shows individual details and any associated notes. ```xml individual_notes execute public Larry Bob Church of Cucumbers ``` -------------------------------- ### Execute Search XML Example Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML request and response structure for the execute_search service. ```xml execute_search execute public …see individual profiles… ``` -------------------------------- ### Valid Individuals API Examples Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for retrieving a list of all individuals within the system. ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=valid_individuals" ``` ```xml true Larry Cucumber Larry Cucumber 2003-11-26 13:03:43 2014-01-07 12:02:31 true Larry Cucumber System User 2013-04-08 06:50:44 2013-07-23 03:28:18 ``` -------------------------------- ### Attendance Profile Service Examples Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for retrieving attendance information for a specific event occurrence. ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=attendance_profile&id=756&occurrence=2014-01-27" ``` ```xml Every. day. part 2 2014-01-27 00:00:00 false Ben Bolton Ben Boltontest ``` -------------------------------- ### Get Individual Groups XML Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML response for retrieving an individual's groups. This shows the structure of group data associated with an individual. ```xml individual_groups execute public 48 48 Larry Bob Larry Bob 1 1 1 Entire Church Group 1 23 23 **Ninja Turtle Club** 1 1 ``` -------------------------------- ### Public Calendar Listing XML Example Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML structure for a public calendar listing request and response. ```xml 2008-11-25 a really fun event 00:00:00 00:15:00 15 Registration Required Awesome Group For Fun People Life Group FUN GROUPING Larry Boy (123) 938-5555 lboy@test.com ``` -------------------------------- ### Lookup Table Service API Examples Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for performing CRUD operations on lookup tables. Invalid IDs in update operations will return empty elements instead of errors. ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=ability_detail&ability_id=9" ``` ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=ability_insert&name=newValue&order_by=3" ``` ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=ability_list" ``` ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=ability_update&ability_id=9&name=BOOKKEEPING" ``` -------------------------------- ### Update Individual Fit API Examples Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for updating an individual's fit attributes. Note that this operation overwrites all existing values for the specified individual. ```curl curl -u user:pass "https://yourchurch.ccbchurch.com/api.php?srv=update_individual_fit&individual_id=1" -d "spiritual_gifts[1]=1&abilities[1]=1&abilities[2]=4" ``` ```xml individual_profiles execute public Skill: Medical Skill: Education Administration ``` -------------------------------- ### Batch Import XML Structure Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML structure required for the import_batches service. ```xml 2013-11-12 2006-05-04 Cash 250.32 note0 10.35 2006-05-04 Check 1234 10 ``` -------------------------------- ### Queue List XML Response Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML structure returned by the queue_list service. ```xml 1. Thank-You Letter This letter is sent by our volunteer letter team to thank the new guest for attending our church services, encouraging them to return and providing information on our service schedule. New Guest Followup 1 Larry Cucumber Larry Cucumber 2007-08-14 10:19:40 2011-09-20 08:08:01 7. Outreach Coordinator Review The Outreach Coordinator will review all the contact made and any notes added to determine if any additional contact should be made or the guest should be added to another process New Guest Followup 30 Larry Cucumber Larry Cucumber 2007-08-14 10:40:53 2010-07-27 12:55:10 ``` -------------------------------- ### GET individual_calendar_listing Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Retrieves a list of calendar events for a specific individual starting from a given date. ```APIDOC ## GET individual_calendar_listing ### Description Retrieves a list of calendar events for a specific individual starting from a given date. ### Method GET ### Parameters #### Query Parameters - **srv** (string) - Required - Must be set to "individual_calendar_listing" - **date_start** (date) - Required - The start date for the calendar listing (YYYY-MM-DD) - **id** (integer) - Required - The ID of the individual ### Response #### Success Response (200) - **item** (array) - A list of event objects containing date, event_name, event_description, start_time, end_time, and leader details. ``` -------------------------------- ### Get Individual Notes cURL Request Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example cURL command to retrieve notes for a specific individual. The individual_id parameter is required. ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=individual_notes&individual_id=48" ``` -------------------------------- ### GET batch_profiles_in_date_range Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Retrieves all batches with a post date within a specified range. If no end date is provided, it defaults to the start date. ```APIDOC ## GET batch_profiles_in_date_range ### Description Retrieves all batches with a post date within a specified range. If no end date is provided, it defaults to the start date. ### Method GET ### Endpoint /api.php?srv=batch_profiles_in_date_range ### Parameters #### Query Parameters - **date_start** (datetime) - Required - The start date for the batch search. - **date_end** (datetime) - Optional - The end date for the batch search. ``` -------------------------------- ### Create Individual via cURL Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example of how to create an individual using a cURL command with HTTP POST parameters. ```bash curl -u user:pass -d "first_name=Ken&last_name=Scott&campus_id=0&family_id=0&family_position=c&gender=m&birthday=2%2F12%2F1966&anniversary=May+6%2C+1989&membership_date=2010-01-01&email=ken%40test.net&mailing_street_address=12265+Oracle+Blvd%2C+Suite+105&mailing_city=Colorado+Springs&mailing_state=CO&mailing_zip=80921&mailing_country=US&mobile_phone=719-266-2888" "https://yourchurch.ccbchurch.com/api.php?srv=create_individual" ``` -------------------------------- ### Get Individual Profile cURL Request Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example cURL command to fetch an individual's profile using their ID. The individual_id parameter is mandatory. ```curl curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=individual_profile_from_id&individual_id=48" ``` -------------------------------- ### Create Individual XML Response Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML structure returned by the create_individual service, detailing individual profile data and privacy settings. ```xml create_individual execute public Church of Cucumbers The Scott Family https://cdn3.ccbchurch.com/preSTABLE/images/group-default.gif Primary Contact Ken Scott Ken Scott 1 https://cdn3.ccbchurch.com/preSTABLE/images/profile-default.gif ken@test.net false
12265 Oracle Blvd, Suite 105 Colorado Springs CO 80921 United States 12265 Oracle Blvd, Suite 105 Colorado Springs, CO 80921 39.010822 -104.815760
M 1966-02-12 false true Group Default Group Default Group Default Never true My Friends My Friends My Friends and Group Members My Friends My Friends My Friends Everyone Everyone Everyone My Friends My Friends Church Leadership true System User System User 2014-01-28 14:24:17 2014-01-28 14:24:17
``` -------------------------------- ### Create Event Response XML Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example of the XML response structure returned after a successful event creation. ```xml create_event execute public Test Event via API 2012-09-27 09:00:00 Sep 27, 2012 9:00 AM 2012-09-27 11:30:00 Sep 27, 2012 11:30 AM America/Denver Every month on the second Tuesday of the month from 9:00 AM to 11:30 AM Entire Church Group Larry Cucumber 0 Open to All 2012-09-27 09:00:00 2012-09-27 11:30:00 System User System User 2014-01-28 14:17:50 2014-01-28 14:17:50 ``` -------------------------------- ### Import Batches via Curl Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Use this curl command to upload an XML file for batch creation. ```bash curl -u user:password -F filedata=@your_local_file_location "http://your_test_site/api.php?srv=import_batches" ``` -------------------------------- ### Create Event via Curl Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example of using a curl command to create an event via an HTTP POST request. ```bash curl -u user:pass -d "name=Test+Event+via+API&start_date=2012-09-27+09:00:00&end_date=2012-09-27+11:30:00&group_id=1&recurrence_type=monthly&recurrence_week_number=second&recurrence_day_of_week=tue" "https://yourchurch.ccbchurch.com/api.php?srv=create_event" ``` -------------------------------- ### Manage Group Leaders XML Example Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html This XML structure demonstrates how to send a request to manage group leaders, specifying the service and group ID. ```xml manage_group_leaders execute public Fours Jacki Clark Carol Darling Dakota Pyle ``` -------------------------------- ### Example XML for Group Participants Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html This XML response shows the structure of data returned when querying for group participants, including participant details. ```xml group_participants execute public Larry Cucumber test@test.com true true false Member 2012-09-20 08:51:01 true Larry Cucumber Larry Cucumber 2012-09-20 08:51:01 2012-09-25 15:46:15 Larry Cucumber Mr. Bob Tom true true false Member 2013-04-08 06:51:45 true Larry Cucumber Larry Cucumber 2013-04-08 06:51:45 2013-04-08 06:51:45 ``` -------------------------------- ### Individual Search API Request Example Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html This cURL command demonstrates how to use the individual_search service to find individuals by last name. Ensure you replace 'user:pass' with your actual credentials and 'yourchurch.ccbchurch.com' with your CCB domain. ```bash curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=individual_search&last_name=Bob" ``` -------------------------------- ### GET campus_list Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Retrieves a list of all campuses available in the system. ```APIDOC ## GET campus_list ### Description The Campus List service returns a list of campuses. ### Method GET ### Endpoint https://yourchurch.ccbchurch.com/api.php?srv=campus_list ### Response #### Success Response (200) - **campuses** (object) - A collection of campus items containing id, name, active status, and creator information. #### Response Example Church of Cucumbers 1 ``` -------------------------------- ### GET campus_profile Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Retrieves detailed information for a specific campus by its ID. ```APIDOC ## GET campus_profile ### Description The Campus Profile service returns campus details for the ID provided. ### Method GET ### Endpoint https://yourchurch.ccbchurch.com/api.php?srv=campus_profile&id={id} ### Parameters #### Query Parameters - **id** (integer) - Required - The unique identifier of the campus. ### Response #### Success Response (200) - **campus** (object) - Detailed campus information including addresses, phones, and timezone. #### Response Example Church of Cucumbers America/Denver ``` -------------------------------- ### Example Output XML for Import Batches Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html This XML represents the output of a successful 'import_batches' API request. It details the structure of batch and transaction data, including associated metadata like campus, individual, dates, and status. ```xml import_batches execute public User Experience Campus 2013-11-12 2016-03-04 2016-03-04 false Closed Created through API User Experience Campus Amy Arnold 2006-05-04 3rd Cash Other 250.32 true note0 System User System User 2016-03-04 01:25:04 2016-03-04 01:25:04 Benevolence 10.35 true System User System User 2016-03-04 01:25:04 2016-03-04 01:25:04 System User System User 2016-03-04 01:25:04 2016-03-04 01:25:04 User Experience Campus Noell Arrington 2006-05-04 Check 1234 Benevolence 10 true System User System User 2016-03-04 01:25:04 2016-03-04 01:25:04 System User System User 2016-03-04 01:25:04 2016-03-04 01:25:04 System User System User 2016-03-04 01:25:04 2016-03-04 01:25:04 ``` -------------------------------- ### Individual Attendance Service Requests and Responses Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Examples for the individual_attendance service using cURL and XML. ```bash curl -u user:pass -d "" "https://yourchurch.ccbchurch.com/api.php?srv=individual_attendance&individual_id=48" ``` ```xml individual_attendance execute public Little Joe Sunday School Entire Church Group 2012-06-17 09:00:00 Kids Club! Entire Church Group 2013-10-17 09:00:00 ``` -------------------------------- ### GET attendance_profiles Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Retrieves attendance data for a specified date range. ```APIDOC ## GET attendance_profiles ### Description Returns attendance data for events within a specified date range. ### Method GET ### Endpoint /api.php?srv=attendance_profiles ### Parameters #### Query Parameters - **start_date** (datetime) - Required - The start of the date range. - **end_date** (datetime) - Required - The end of the date range. ``` -------------------------------- ### Fetch Saved Searches (XML) Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Example XML for requesting and receiving a list of saved searches. The response includes details like search ID, name, and creator. ```xml search_list execute public Indiv. Created in Last Month 2010-09-04 08:14:34 1 Larry Cucumber Larry Cucumber 2005-05-24 17:04:25 2010-09-04 08:14:34 106 Larry!!! 2012-11-21 10:56:17 1 Larry Cucumber Larry Cucumber 2012-11-21 10:56:17 2012-11-21 10:56:17 117 ``` -------------------------------- ### GET attendance_profile Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Retrieves attendance information for a specific occurrence of an event. ```APIDOC ## GET attendance_profile ### Description Retrieves attendance information for a provided occurrence of an event. ### Method GET ### Endpoint /api.php?srv=attendance_profile ### Parameters #### Query Parameters - **id** (integer) - Required - The ID of the event. - **occurrence** (datetime) - Required - The date of the event occurrence. ### Response #### Success Response (200) - **event** (object) - Contains event details including name, occurrence, and list of attendees. ``` -------------------------------- ### GET transactions_by_family Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Retrieves transaction records associated with a specific family. ```APIDOC ## GET transactions_by_family ### Description Retrieves transaction records for a specific family, with optional date filtering. ### Method GET ### Endpoint https://yourchurch.ccbchurch.com/api.php?srv=transactions_by_family ### Parameters #### Query Parameters - **srv** (string) - Required - The service name: transactions_by_family - **family_id** (integer) - Required - The ID of the family. - **date_start** (datetime) - Optional - Start date for filtering transactions. - **date_end** (datetime) - Optional - End date for filtering transactions. - **modified_since** (datetime) - Optional - Filter transactions modified since this date. ``` -------------------------------- ### POST create_individual Source: https://designccb.s3.amazonaws.com/helpdesk/files/official_docs/api.html Creates a new individual and family profile in the system. ```APIDOC ## POST create_individual ### Description The Create Individual service accepts form-encoded data to create a new individual and family in the Pushpay system. ### Method POST ### Endpoint https://yourchurch.ccbchurch.com/api.php?srv=create_individual ### Parameters #### Request Body - **first_name** (string) - Required - The first name of the individual - **last_name** (string) - Required - The last name of the individual ```