Search people

get

https://{tenant}.onechurchsoftware.com/api/people

Retrieve a list of people matching the given filters. Returns person records by default; set business=true to return business records instead.

Custom field filters are also supported as dynamic query parameters: pass the field id as the parameter name (e.g. ?123=value). See filtering by custom fields for how custom field parameters work.

Required permission: Limited Read People

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

name

string

Text matched against first, middle, last and former names plus aliases. When multiple words are given, every word must match.

archived

boolean

Whether to return archived (true) or active (false) profiles. If omitted, both are returned.

key.start

double

Return profiles whose id is greater than or equal to this value.

key.end

double

Return profiles whose id is less than or equal to this value.

first

string

Return profiles whose first name contains the given text.

last

string

Return profiles whose last name contains the given text.

letter

string

Return profiles whose last name starts with the given letter.

string

Return profiles whose email address (their own or their family's) contains the given text.

phone

string

Return profiles whose phone number (their own or their family's) contains the given digits.

envelope

int32

The envelope number assigned to the person. Use -1 to return profiles with no envelope number.

address.street

string

The street address.

address.city

string

The city.

address.state

string

The state or province.

address.postalCode

string

The postal code.

address.country

string

The country.

type

string

Comma-delimited list of record type ids. Values come from /api/property_values/person_record_type/values.

gender

string

Comma-delimited list of gender ids. Values come from /api/property_values/gender/values.

language

string

Comma-delimited list of language ids. Values come from /api/property_values/languages/values.

ethnicity

string

Comma-delimited list of ethnicity ids. Values come from /api/property_values/ethnicities/values.

maritalStatus

string

Comma-delimited list of marital status ids. Values come from /api/property_values/marital_status/values.

position

string

Comma-delimited list of household role ids. Values come from /api/property_values/household_roles/values.

race

string

Comma-delimited list of race ids. Values come from /api/property_values/race/values.

occupation

string

Comma-delimited list of occupation ids. Values come from /api/property_values/occupations/values.

campus

string

Comma-delimited list of campus (location) ids. Use -1 to include profiles with no campus.

birthday.month

int32

Match dates falling in this month (1-12).

birthday.day

int32

Match dates falling on this day of the month (1-31).

birthday.year

int32

Match dates falling in this year.

birthday.start

date-time

Match dates falling within a window starting at this date.

birthday.end

date-time

Match dates falling within a window ending at this date.

anniversary.month

int32

Match dates falling in this month (1-12).

anniversary.day

int32

Match dates falling on this day of the month (1-31).

anniversary.year

int32

Match dates falling in this year.

anniversary.start

date-time

Match dates falling within a window starting at this date.

anniversary.end

date-time

Match dates falling within a window ending at this date.

age.start

double

Return people whose age is greater than or equal to this value.

age.end

double

Return people whose age is less than or equal to this value.

business

boolean

Whether to return business records (true) or person records (false). Defaults to false.

recurring

boolean

Whether the person has at least one active recurring giving schedule.

createdBy

string

Return profiles created by the given user name.

filter

string

Free text search across the profile's names, former names, email, phone and address.

skip

int32

≥ 0

The number of records to skip before returning results, used for paging.

limit

int32

≥ 0

The maximum number of records to return per page. Defaults to 50.

sort.property

string

The field to sort the results by. The default field depends on the endpoint.

sort.dir

string

enum

The sort direction: "asc" or "desc".

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

text/json

200OK