Example use cases
This endpoint allows you to find tenants based on lease parameters. You can retrieve tenants for a lease with a specific ID. You can retrieve tenants for all leases within a minimum (min_move_in_date
) and/or maximum (max_move_in_date
) move in date range.
You can retrieve tenants for leases belonging specific group via the group’s ID.
You can retrieve tenants with a lease at a particular address, with the possibility of narrowing or broadening the search by providing more or less address data.
You can provide either a group id through the group_id
parameter or a group external reference through the group_external_ref
attribute to filter the list of retrieved tenants down.
Do not provide both, as this will result in the request failing.
If no group_id or group_external_ref are specified in the request body, the authenticated user will retrieve tenant records for all groups they have access to.
Header
The authentication token for your request
Body
The identifier of a lease to find the tenants for.
The lower boundary for the lease’s tenants’ move in date.
The upper boundary for the lease’s tenants’ move in date.
The id of the group the lease and tenants belong to.
The external reference of the group the lease and tenants belong to.
The address of a lease to retrieve tenants for.
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 tenants 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.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 id and external ref provided for the tenant find operation
No tenant records found for the provided parameters