Tenancies

List Tenancies

Retrieves a paginated list of tenancies, with optional filtering and inclusion of tenant data.

get/tenancies

Request

  • Base URL: https://api.alto.zoopladev.co.uk
  • URL: https://api.alto.zoopladev.co.uk/tenancies
  • Auth: appAuth (a scheme the document does not define)

Query parameters

next-tokenstring

Token used to retrieve the next page of results. This is returned in the response of the previous page.

max-resultsinteger

Maximum number of results to return per page. Defaults to 100 if not specified.

sort-order'Asc' | 'Desc'

The order of results by tenancy id. Ascending by default. A next-token can only be used with the sort order it was issued for.

statusstring[]

Only return tenancies with one of these statuses, by name, comma-separated or repeated. All statuses are returned when not specified.

created-fromstring date-time

The start date for filtering tenancies by created date.

created-tostring date-time

The end date for filtering tenancies by created date.

modified-fromstring date-time

The start date for filtering tenancies by modified date.

modified-tostring date-time

The end date for filtering tenancies by modified date.

start-date-fromstring date-time

The start date for filtering tenancies by start date.

start-date-tostring date-time

The end date for filtering tenancies by start date.

target-vacate-date-fromstring date-time

The start date for filtering tenancies by target vacate date.

target-vacate-date-tostring date-time

The end date for filtering tenancies by target vacate date.

first-full-rent-date-fromstring date-time

The start date for filtering tenancies by first full rent date.

first-full-rent-date-tostring date-time

The end date for filtering tenancies by first full rent date.

notice-to-quit-date-fromstring date-time

The start date for filtering tenancies by notice to quit date.

notice-to-quit-date-tostring date-time

The end date for filtering tenancies by notice to quit date.

end-date-fromstring date-time

The start date for filtering tenancies by end date.

end-date-tostring date-time

The end date for filtering tenancies by end date.

renewal-date-fromstring date-time

The start date for filtering tenancies by renewal date.

renewal-date-tostring date-time

The end date for filtering tenancies by renewal date.

include-tenantsboolean

Controls whether tenants should be included in the response for each tenancy result. By default tenants will not be included.

Headers

AgencyRefstring required

A GUID required in the header of all API requests that grants access to an agent's data

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.