group_ids
parameter or a list of group external references through the groups_external_refs
attribute to filter the list of retrieved persons down.
Do not provide both, as this will result in the request failing.
If no group_ids or group_external_refs are specified in the request body, the authenticated user will retrieve person records for all groups they have access to.
Header
The authentication token for your request
Body
The first name of the persons you want to retrieve.
The last name of the persons you want to retrieve.
The email adddress of the persons you want to retrieve.
The phone number of the persons you want to retrieve.
The external reference of the persons you want to retrieve.
Internal identifier of the persons you want to retrieve.
The list of group ids for filtering the retrieved list.
The list of group external references for filtering the retrieved list.
The API returns a maximum of 100 records per call.You can use this parameter to load the next set of records by passing in the value returned in the response, under
last_id
.Response
A list of the persons that have been retrieved.
The last id in the set of results returned for this API call.You can use this value in the
after-id
parameter to load the next set of results.If there are no more results to load, this value will be -1.Please note that this is unrelated to the external reference or the internal identifier.Errors
Listed below are common errors that may be returned by the endpoint, along with their corresponding status code. Status Code - 400Missing Authorization header
Expired Authorization header bearer token value
Invalid Authorization header bearer token value
Both group ids and external refs provided for the person find operation
No person records found for the provided parameters