Get Properties By Filter

Changed on

Rule-engine-based list endpoint — an alternative to the simple filter.* query params on the plain list endpoint, for building complex AND/OR filter conditions. This endpoint is served by a separate microservice from most of the API (not master_service), and its filter schema differs in two ways from other modules' generic-filter endpoints: each filter_rules entry also carries an explicit field_type, and the operator enum is wider (adds GREATER_THAN_EQUAL_TO, LESS_THAN_EQUAL_TO, IN). sort_by only accepts property_name or created_at — the smallest allow-list of any filter endpoint in the API (note: the service's own 400 validation message text says "created_by", but the actual accepted value is created_at — a mismatch in the error message itself, not in behavior). A filter_rules entry with key: "keyword" is pulled out and used as a free-text search instead of going through the rule engine.

post/property/filter

Request

  • Base URL
    https://dc-region.zuperpro.com/api
  • URL
    https://dc-region.zuperpro.com/api/property/filter
  • Auth
    API key in header x-api-key

Request body

pageinteger
limitinteger

Also accepted as count. Max 1000 — larger values return 400 COUNT_LIMIT_EXCEEDED.

countinteger

Alias for limit.

sort'ASC' | 'DESC'
sort_by'property_name' | 'created_at'
filter_rule_operator'AND' | 'OR'
filter.module_uidstring

Comma-separated list of this module's own UIDs to restrict to.

fields_to_selectstring
preferred_timezonestring
cursorstring
prev_cursorstring
cursor_paginationboolean

Switches the response to the cursor-paginated shape.

last_pageboolean

Response

200

type'SUCCESS'
dataobject[]

Property documents — same shape as GET /property. Switches to the cursor-paginated shape ({type, data, current_page_records, total_records, paging} — this is the only one of the three modules that keeps current_page_records even in cursor mode) when cursor_pagination/cursor/prev_cursor/last_page is sent.

current_page_recordsinteger

Length of the data array returned in this page.

total_recordsinteger
current_pageinteger
total_pagesinteger

Changes