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

# Get Leads Created

`GET /crm/leads/created`

Retrieve leads created within a time window (default: last 4 hours).

Returns leads whose `created_ts` falls within the specified date range. If neither
`start_date` nor `end_date` is provided, defaults to a rolling 4-hour window
ending at the current UTC time — useful for near-real-time polling.

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

Pass `start_date` and/or `end_date` as query parameters to customize the time window.
Both accept **ISO 8601 UTC** strings.

- Format: `YYYY-MM-DDTHH:MM:SSZ` (full) or `YYYY-MM-DD` (date only = midnight UTC)
- If only `start_date` is provided, returns all leads created from that point to now.
- If only `end_date` is provided, returns leads created from (now − 4h) to that point.
- If both are provided, returns leads created within that exact window.

**Example requests:**

- Leads created in the last 4 hours (default):
  `GET /leads/created`
- Leads created in the last 7 days:
  `GET /leads/created?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z`
- Leads created since March 1st:
  `GET /leads/created?start_date=2026-03-01`
- Leads created in the last 7 days with status "assigned":
  `GET /leads/created?start_date=2026-03-22&match_filter_dict={"lead_status": "assigned"}`

**Other Query Parameters:**

- **match_filter_dict** *(optional)*: JSON-encoded MongoDB filter applied on top of
  the time window. Use for non-date fields only.
  Filterable fields: `lead_status`, `lead_source`, `name`, `email_list`, `phone_list`,
  `tags`, `employer_name`, `profession`, `title`.

**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 (e.g. 2026-03-22T00:00:00Z). Defaults to now − 4 hours.
- `end_date` string, nullable — End of date range in ISO 8601 format (e.g. 2026-03-29T23:59:59Z). 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

---

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