Skip to main content
GET
List people

Authorizations

Authorization
string
header
required

An API key from Settings, API keys. It starts with rc_live_.

Query Parameters

limit
integer
default:25

How many to return. 25 unless you say, 100 at most.

Required range: 1 <= x <= 100
offset
integer
default:0

How many to skip, for the next page.

Required range: x >= 0
sort
enum<string>
default:created_at
Available options:
display_name,
first_name,
last_name,
email,
status,
created_at,
updated_at
dir
enum<string>
default:desc
Available options:
asc,
desc

People whose first name, last name or email contains this.

role
enum<string>

People who hold this role.

Available options:
adopter,
donor,
volunteer,
foster
status
string

People with this status: active, inactive or archived. Any other value matches nobody.

tag
string

People carrying this tag. Several tags separated by commas match a person carrying any of them.

name
string

The full name contains this.

first_name
string

The first name contains this.

last_name
string

The last name contains this.

email
string

The email address contains this.

phone
string

The phone number contains these digits. Phone numbers are kept as digits only.

created_at_from
string

Added on or after this date or time.

created_at_to
string

Added on or before this. It is compared with the full time, so a bare date here means the very start of that day.

updated_at_from
string

Last changed on or after this date or time.

updated_at_to
string

Last changed on or before this. It is compared with the full time, so a bare date here means the very start of that day.

Response

One page of people.

results
object[]
required
limit
integer
required
offset
integer
required
has_more
boolean
required

Whether there is another page after this one.

total
integer
required

How many people match in all.