Get Leads Status Updated

Retrieve leads whose status was updated within a time window (default: last 1 hour).

Returns leads where status_update_date falls within the specified range. If neither start_date nor end_date is provided, defaults to the last 60 minutes (UTC). Useful for detecting status changes such as leads moving from "assigned" to "contacted".

Time-based filtering (start_date / end_date):

• Format: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
• Default window (no params): last 1 hour
• Provide start_date and/or end_date to customize the window.

Example requests:

• Status changes in the last 1 hour (default): GET /leads/status_updated
• Status changes in the last 7 days: GET /leads/status_updated?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z
• Status changes since yesterday, only "contacted" leads: GET /leads/status_updated?start_date=2026-03-28&match_filter_dict={"lead_status": "contacted"}

Other Query Parameters:

• match_filter_dict (optional): JSON-encoded MongoDB filter for non-date fields. Filterable fields: lead_status, lead_source, name, tags.

Response: Array of lead objects (same schema as GET /leads).