Navigation

Fetch Saved Searches

Retrieve all saved property searches for a contact

POST /public/real_estate/fetchSavedSearches

Returns all non-deleted saved searches for a given contact, ordered by creation date (newest first). Each search includes its filter criteria, notification frequency, last and next run timestamps, result counts, and status.

Requires a valid api_key in the JSON request body

Tip: Send {"help": true} as the request body to receive full usage documentation and a sample response directly from the endpoint — no authentication required for help mode.

Parameters

Name In Type Required Description
api_key body string Yes Your Zyntro API key
org_id body string Yes Your organization UUID
contact_id body string Yes The UUID of the contact to retrieve saved searches for

Request Body

Content-Type: application/json

Example

json 
{
    "org_id": "YOUR_ORG_ID",
    "api_key": "YOUR_API_KEY",
    "contact_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Code Samples

bash 
curl -X POST https://app.zyntrohq.com/public/real_estate/fetchSavedSearches \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "org_id": "YOUR_ORG_ID",
    "contact_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

Response

200 Saved searches retrieved
json 
{
    "data": [
        {
            "name": "Barrie Detached 3+ BR under $1M",
            "uuid": "e7f8a9b0-c1d2-3456-e7f8-a9b0c1d23456",
            "status": "Active",
            "filters": {
                "city": "Barrie",
                "min_beds": 3,
                "max_price": 1000000,
                "min_price": 500000,
                "property_type": "Residential",
                "property_sub_type": "Detached"
            },
            "frequency": "weekly",
            "created_at": "2026-03-01 10:30:00",
            "created_by": "member",
            "updated_at": "2026-03-31 12:00:00",
            "last_run_at": "2026-03-31 12:00:00",
            "next_run_at": "2026-04-07 12:00:00",
            "last_results_count": 42,
            "notification_email": "[email protected]"
        },
        {
            "name": "Innisfil Waterfront",
            "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "status": "Active",
            "filters": {
                "city": "Innisfil",
                "min_price": 800000,
                "property_type": "Residential"
            },
            "frequency": "daily",
            "created_at": "2026-03-15 09:00:00",
            "created_by": "contact",
            "updated_at": "2026-04-02 08:00:00",
            "last_run_at": "2026-04-02 08:00:00",
            "next_run_at": "2026-04-03 08:00:00",
            "last_results_count": 7,
            "notification_email": "[email protected]"
        }
    ],
    "count": 2,
    "status": "success"
}
200 No saved searches found
json 
{
    "data": [],
    "count": 0,
    "status": "success"
}
200 Error response
json 
{
    "status": "error",
    "message": "Contact not found"
}

Info: Deleted saved searches are excluded from the response. Only searches with status Active or Paused are returned. The response is ordered by creation date, newest first.

Errors

Code Message Resolution
INVALID_JSON Invalid JSON input
The request body is not valid JSON. 		Send valid JSON. Use {"help": true} for usage docs.
MISSING_FIELDS api_key / org_id / contact_id is required
One or more required fields are missing. 		Include all three required fields.
INVALID_API_KEY Invalid API key
No active user matches the key. 		Verify your key.
INACTIVE_USER User account is not active
The account is deactivated. 		Contact your admin.
CONTACT_NOT_FOUND Contact not found
No contact with that ID exists in the organization. 		Verify contact_id and org_id.
DB_ERROR Database error — reso_saved_searches table may not exist
The saved searches table is not available. 		Contact support — the real estate module may not be provisioned for your account.
3 min read Updated Apr 2, 2026

Was this article helpful?

NotebookLM Overviews