---
title: "Get Orders Updated"
method: GET
path: "/crm/orders/updated"
tags: ["CRM Service Calls"]
---

# Get Orders Updated

`GET /crm/orders/updated`

Retrieve orders updated within a time window (default: last 4 hours).

Returns orders whose `updated_ts` falls within the specified date range. Captures
stage changes, amount adjustments, or any other modifications.

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

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

**Example requests:**

- Orders updated in the last 4 hours (default):
  `GET /orders/updated`
- Orders updated in the last 7 days:
  `GET /orders/updated?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z`
- Fulfilled orders updated this month:
  `GET /orders/updated?start_date=2026-03-01&match_filter_dict={"stage": "fulfilled"}`

**Other Query Parameters:**

- **match_filter_dict** *(optional)*: JSON-encoded MongoDB filter for non-date fields.
  Filterable fields: `stage`, `order_type`, `total_amount`, `account_id`, `contact_id`.

**Response:** Array of order objects (same schema as GET /orders).

## Query parameters

- `match_filter_dict` string
- `start_date` string, nullable — Start of date range in ISO 8601 format. Defaults to now − 4 hours.
- `end_date` string, nullable — End of date range in ISO 8601 format. Defaults to now.

## Response `200`

Successful Response

- OrderResponse[]
  - `id` string, required
  - `name` string, nullable
  - `stage` string, nullable
  - `description` string, nullable
  - `order_num` string, nullable
  - `order_type` string, nullable
  - `order_date` string, nullable
  - `total_amount` string, nullable
  - `agreement_signed_date` string, nullable
  - `created_ts` string, nullable
  - `created_ts_date` string, nullable
  - `updated_ts` string, nullable
  - `updated_ts_date` string, nullable
  - `account` string, nullable
  - `primary_sales_agent_email` string, nullable
  - `contact` string, nullable
  - `opportunity` string, 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)