---
title: "Get Leads Status Updated"
method: GET
path: "/crm/leads/status_updated"
tags: ["CRM Service Calls"]
---

# Get Leads Status Updated

`GET /crm/leads/status_updated`

## Request

- Base URL: `https://fapi.ambivo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://fapi.ambivo.com/crm/leads/status_updated`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ambivo/apis/ambivo-api/docs/crm/leads/status_updated/get.ts> (a function with typed inputs; its response is checked against the schema)

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).

## Query parameters

- `match_filter_dict` string
- `start_date` string, nullable: Start of date range in ISO 8601 format. Defaults to now − 1 hour.
- `end_date` string, nullable: End of date range in ISO 8601 format. Defaults to now.

## Response `200`

Successful Response

- LeadResponse[]
  - `id` string, required
  - `phone_list` unknown[], nullable, required
    - unknown
  - `email_list` unknown[], nullable, required
    - unknown
  - `first_name` string, nullable, required
  - `last_name` string, nullable, required
  - `name` string, required
  - `status` string, required
  - `marketing_source` string, nullable
  - `created_date` string, nullable, required
  - `updated_date` string, nullable, required
  - `status_updated_date` string, nullable, required
  - `tags` string[], nullable
  - `social_dict_list` object[], nullable
  - `is_converted` boolean: Whether lead has been converted to contact
  - `contact_id` string, nullable: Contact ID if converted
  - `has_deal` boolean: Whether a deal/opportunity exists
  - `deal_stage` string, nullable: Current deal stage if exists
  - `deal_id` string, nullable: Deal/Opportunity ID if exists
  - `value_of_sale` number, nullable: Value of sale for the deal if exists
  - `close_date` string, nullable: Close date of the deal in ISO 8601 format

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-06** `165a6d16a9a0`: 1 breaking, 14 info
  - removed the required property `items/lead_status` from the response with the `200` status
  - added the new optional `query` request parameter `end_date`
  - added the new optional `query` request parameter `start_date`
  - added the optional property `items/close_date` to the response with the `200` status
  - …11 more

[Operation history](https://skmtc.dev/ambivo/apis/ambivo-api/changes/crm/leads/status_updated/get.md)

---

[API](https://skmtc.dev/ambivo/apis/ambivo-api.md) - [All operations](https://skmtc.dev/ambivo/apis/ambivo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ambivo/apis/ambivo-api/revisions/165a6d16a9a0?raw)