API
⌘K
My Developer Account

Organization

The organization represents a single church. Every other resource is scoped to this record.

Example Request

curl https://api.planningcenteronline.com/people/v2

View in API Explorer →

Example Object

{
  "type": "Organization",
  "id": "1",
  "attributes": {
    "avatar_url": "string",
    "church_center_subdomain": "string",
    "contact_website": "string",
    "country_code": "string",
    "created_at": "2000-01-01T12:00:00Z",
    "date_format": 1,
    "grades": [],
    "name": "string",
    "time_zone": "string"
  },
  "relationships": {}
}

Attributes

Name Type Description
avatar_url string
church_center_subdomain string
contact_website string
country_code string
created_at date_time
date_format integer
grades array
id primary_key
name string
time_zone string

Pagination

Name Parameter Type Description
per_page per_page integer how many records to return per page (min=1, max=100, default=25)
offset offset integer get results from given offset

Endpoints

Listing

HTTP Method Endpoint
GET /people/v2

Reading

HTTP Method Endpoint
GET /people/v2/{id}

Associations

HTTP Method Endpoint Returns Details Filter By
GET https://api.planningcenteronline.com/people/v2/addresses Address
GET https://api.planningcenteronline.com/people/v2/apps App
GET https://api.planningcenteronline.com/people/v2/background_checks BackgroundCheck
  • current
GET https://api.planningcenteronline.com/people/v2/birthday_people BirthdayPeople
GET https://api.planningcenteronline.com/people/v2/campuses Campus
GET https://api.planningcenteronline.com/people/v2/carriers Carrier
GET https://api.planningcenteronline.com/people/v2/emails Email
GET https://api.planningcenteronline.com/people/v2/field_data FieldDatum
GET https://api.planningcenteronline.com/people/v2/field_definitions FieldDefinition
  • include_deleted
GET https://api.planningcenteronline.com/people/v2/form_categories FormCategory
GET https://api.planningcenteronline.com/people/v2/forms Form
  • archived
  • closed
  • not_archived
  • open
  • recently_viewed
  • with_recoverable
GET https://api.planningcenteronline.com/people/v2/households Household
GET https://api.planningcenteronline.com/people/v2/inactive_reasons InactiveReason
GET https://api.planningcenteronline.com/people/v2/list_categories ListCategory
GET https://api.planningcenteronline.com/people/v2/lists List
  • can_manage
  • recently_viewed
  • starred
  • unassigned
GET https://api.planningcenteronline.com/people/v2/marital_statuses MaritalStatus
GET https://api.planningcenteronline.com/people/v2/message_groups MessageGroup
GET https://api.planningcenteronline.com/people/v2/messages Message
  • created_after
GET https://api.planningcenteronline.com/people/v2/name_prefixes NamePrefix
GET https://api.planningcenteronline.com/people/v2/name_suffixes NameSuffix
GET https://api.planningcenteronline.com/people/v2/note_categories NoteCategory
  • view_creatable
GET https://api.planningcenteronline.com/people/v2/note_category_subscriptions NoteCategorySubscription
GET https://api.planningcenteronline.com/people/v2/notes Note
GET https://api.planningcenteronline.com/people/v2/people Person
  • admins
  • created_since
  • organization_admins
GET https://api.planningcenteronline.com/people/v2/people_imports PeopleImport
GET https://api.planningcenteronline.com/people/v2/person_mergers PersonMerger
GET https://api.planningcenteronline.com/people/v2/phone_numbers PhoneNumber
GET https://api.planningcenteronline.com/people/v2/reports Report
GET https://api.planningcenteronline.com/people/v2/school_options SchoolOption
GET https://api.planningcenteronline.com/people/v2/social_profiles SocialProfile
GET https://api.planningcenteronline.com/people/v2/spam_email_addresses SpamEmailAddress
GET https://api.planningcenteronline.com/people/v2/stats OrganizationStatistics
GET https://api.planningcenteronline.com/people/v2/tabs Tab
  • with_field_definitions
GET https://api.planningcenteronline.com/people/v2/workflows Workflow
  • archived
  • has_my_cards
  • manage_cards_allowed
  • not_archived
  • only_deleted
  • recently_viewed
  • unassigned
  • with_deleted
  • with_recoverable
  • with_steps

Belongs To

HTTP Method Endpoint Association Details Filter By
GET https://api.planningcenteronline.com/people/v2/people/{person_id}/organization Person