---
title: "Search endpoint for client_properties (deals)"
method: GET
path: "/client_properties"
tags: ["client_properties"]
---

# Search endpoint for client_properties (deals)

`GET /client_properties`

This endpoint returns a list of client properties (deals).

Filters:

- updated_at_from, updated_at_to: ISO dates, both required together
- deal_pipeline_id: Integer
- deal_stage_id: Comma-separated integers (e.g. `1,2,3`)
- property_id: Comma-separated integers (e.g. `10,11`)

Supports pagination via `page` and `per`, and ordering via `order` and `sort_by`.

## Query parameters

- `with_total` boolean
- `page` integer
- `per` integer
- `updated_at_from` string, date
- `updated_at_to` string, date
- `order` 'asc' | 'desc'
- `sort_by` string
- `deal_pipeline_id` integer
- `category` 'qualified' | 'unqualified' | 'lost'

## Response `200`

Search endpoint for client_properties (deals)

- EndpointsClientProperties — Endpoints_ClientProperties model
  - `data` ClientPropertyEntity[]
    - `id` integer
    - `sold_price` integer
    - `broker_id` integer
    - `client_id` integer
    - `property_id` integer
    - `project_id` integer
    - `client_source_id` integer
    - `deal_pipeline_id` integer
    - `deal_stage_id` integer
    - `reservation_reason_id` integer
    - `custom_fields` object
    - `buy_reason` string
    - `home_owner` boolean
    - `employment_status` string
    - `number_of_persons` string
    - `own_capital` string
    - `household_net_income_range` string
    - `max_budget` number, float
    - `search_advance_phase` string
    - `financing_status` string
    - `note` string
    - `start_date` string
    - `created_at` string
    - `updated_at` string
  - `total` integer — Show the total count of client properties

## Other responses

- `400` — validation_error
- `401` — authentication_error
- `403` — authorization_error
- `404` — not_found_error
- `422` — validation_error
- `500` — internal_server_error

---

[API](https://skmtc.net/propstack/apis/propstack-api-v2-beta.md) · [All operations](https://skmtc.net/propstack/apis/propstack-api-v2-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/propstack/propstack-api-v2-beta/revisions/ae1e0fe6da1a/schema)