AMambivo
CRM Service Calls

Get Deals Updated

Changed on

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

Request

Query parameters

match_filter_dictstring
start_datestring nullable

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.

Response

Successful Response

idstring required
namestring required
stagestring required
marketing_sourcestring nullable
agent_namestring nullable
agent_emailstring nullable
agent_phonestring nullable
contact_namestring nullable
contact_emailstring nullable
contact_phonestring nullable
account_namestring nullable
account_emailstring nullable
value_of_salestring nullable
estimated_value_of_salestring nullable
created_datestring nullable
updated_datestring nullable
expected_close_datestring nullable
close_datestring nullable
renewal_datestring nullable

Changes

  • 165a6d16a9a0Revision changes
    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • info

      api operation id get_contacts_status_updated_crm_deals_updated_get removed and replaced with get_deals_updated_crm_deals_updated_get

    • info

      added the new optional query request parameter end_date

    • info

      added the new optional query request parameter start_date