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

# Get Contacts Status Updated

`GET /crm/contacts/status_updated`

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

Returns contacts where `status_update_date` falls within the specified range. Defaults
to the last 60 minutes (UTC) when no dates are provided.

**Time-based filtering (start_date / end_date):**

- Format: `YYYY-MM-DDTHH:MM:SSZ` or `YYYY-MM-DD`
- Default window (no params): last 1 hour

**Example requests:**

- Status changes in the last 1 hour (default):
  `GET /contacts/status_updated`
- Status changes in the last 7 days:
  `GET /contacts/status_updated?start_date=2026-03-22&end_date=2026-03-29`
- Only "meeting-setup" contacts since yesterday:
  `GET /contacts/status_updated?start_date=2026-03-28&match_filter_dict={"status": "meeting-setup"}`

**Other Query Parameters:**

- **match_filter_dict** *(optional)*: JSON-encoded MongoDB filter for non-date fields.
  Example: `{"status": "meeting-setup"}`

**Response:** Array of contact objects (same schema as GET /contacts).

## 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

- ContactResponse[]
  - `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

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)