v1
latestOpenAPI 3.1.02026-08-069158174.8 KBCRM Service Calls
Get Deals Updated
Retrieve deals/opportunities updated within a time window (default: last 4 hours).
Returns deals whose updated_ts falls within the specified date range. Captures stage changes, value updates, or any other modifications. Defaults to last 4 hours.
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 updated in the last 4 hours (default): GET /deals/updated
- Deals updated in the last 7 days: GET /deals/updated?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z
- Closed-won deals updated this week: GET /deals/updated?start_date=2026-03-24&match_filter_dict={"stage": "closed_won"}
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).
get/crm/deals/updated
Query parameters
match_filter_dictstring
start_datestring nullable
Start of date range in ISO 8601 format. Defaults to now − 4 hours.
Start of date range in ISO 8601 format. Defaults to now − 4 hours.
end_datestring nullable
End of date range in ISO 8601 format. Defaults to now.
End of date range in ISO 8601 format. Defaults to now.
Response
Successful Response