Apis::V4::PeopleSearch API

search with specific fields

Parameters

Name Description
access_token JSON Web Token retrieved from the Sessions endpoint (you can also passthis into the Authorization header)
q search string, the system will try to search by first and last name, or email address if you include a '@'
limit max number of people to return. Defaults to 10.
organization_ids (optional) only look in these organizations
fields hash of fields you want for model types. the person type will default to these fields: first_name,last_name,gender,primary_email_address. But you could request picture if you want to receive that as well.

Request

Headers

Version: HTTP/1.0
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxNDcsImV4cCI6MTc1NDU5NjQ4NiwiaWF0IjoxNzU0NTk2MzA2fQ.o3jeAsQl8VaEjTmcbvg1RS2EozdWd3f67-IacaUCEWw
Host: example.org
Cookie: 

Route

GET /apis/v4/search?q=Ultr&fields%5Bperson%5D=first_name%2Cpicture

Query Parameters

q=Ultr
fields={"person"=>"first_name,picture"}

Response

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Download-Options: noopen
X-Permitted-Cross-Domain-Policies: none
Referrer-Policy: strict-origin-when-cross-origin
Content-Type: application/vnd.api+json
Vary: Accept
X-MH-Session: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxNDcsImV4cCI6MTc1NDc2OTEwNiwiaWF0IjoxNzU0NTk2MzA2fQ.Huj7aiR5GyMKW55eWvzzm2l2i7LdOIxJixLzAbrZR4g
Access-Control-Expose-Headers: X-MH-Session
ETag: W/"e17e5fa769f4d69355f8cb7a55219072"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 98d1da12-a69e-4677-907c-733a78afb1a9
X-Runtime: 0.056098
Content-Length: 2867

Status

200

Body