---
title: "Get Deals Created"
method: GET
path: "/crm/deals/created"
tags: ["CRM Service Calls"]
---

# Get Deals Created

`GET /crm/deals/created`

## 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/deals/created`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ambivo/apis/ambivo-api/docs/crm/deals/created/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve deals/opportunities created within a time window (default: last 4 hours).

Returns deals whose `timestamp` (creation time) falls within the specified date range.
If neither `start_date` nor `end_date` is provided, defaults to a rolling 4-hour window.

**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:**

- Deals created in the last 4 hours (default):
  `GET /deals/created`
- Deals created in the last 7 days:
  `GET /deals/created?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z`
- Discovery-stage deals created this month:
  `GET /deals/created?start_date=2026-03-01&match_filter_dict={"stage": "discovery"}`

**Other Query Parameters:**

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

**Response:** Array of deal objects (same schema as GET /deals).

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

- DealResponse[]
  - `id` string, required
  - `name` string, required
  - `stage` string, required
  - `marketing_source` string, nullable
  - `agent_name` string, nullable
  - `agent_email` string, nullable
  - `agent_phone` string, nullable
  - `contact_name` string, nullable
  - `contact_email` string, nullable
  - `contact_phone` string, nullable
  - `account_name` string, nullable
  - `account_email` string, nullable
  - `product_dict_list` unknown[], nullable
    - unknown
  - `value_of_sale` string, nullable
  - `estimated_value_of_sale` string, nullable
  - `created_date` string, nullable
  - `updated_date` string, nullable
  - `expected_close_date` string, nullable
  - `close_date` string, nullable
  - `renewal_date` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-06** `165a6d16a9a0`: 17 breaking, 2 info
  - the response property `items/account_email` became optional for the status `200`
  - the response property `items/account_name` became optional for the status `200`
  - the response property `items/agent_email` became optional for the status `200`
  - the response property `items/agent_name` became optional for the status `200`
  - …15 more

[Operation history](https://skmtc.dev/ambivo/apis/ambivo-api/changes/crm/deals/created/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)