AMambivo
CRM Service Calls

Get Leads Status Updated

Changed on

Retrieve leads whose status was updated within a time window (default: last 1 hour).

Returns leads where status_update_date falls within the specified range. If neither start_date nor end_date is provided, defaults to the last 60 minutes (UTC). Useful for detecting status changes such as leads moving from "assigned" to "contacted".

Time-based filtering (start_date / end_date):

  • Format: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
  • Default window (no params): last 1 hour
  • Provide start_date and/or end_date to customize the window.

Example requests:

  • Status changes in the last 1 hour (default): GET /leads/status_updated
  • Status changes in the last 7 days: GET /leads/status_updated?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z
  • Status changes since yesterday, only "contacted" leads: GET /leads/status_updated?start_date=2026-03-28&match_filter_dict={"lead_status": "contacted"}

Other Query Parameters:

  • match_filter_dict (optional): JSON-encoded MongoDB filter for non-date fields. Filterable fields: lead_status, lead_source, name, tags.

Response: Array of lead objects (same schema as GET /leads).

get/crm/leads/status_updated

Request

Query parameters

match_filter_dictstring
start_datestring nullable

Start of date range in ISO 8601 format. Defaults to now − 1 hour.

end_datestring nullable

End of date range in ISO 8601 format. Defaults to now.

Response

Successful Response

idstring required
first_namestring nullable required
last_namestring nullable required
namestring required
statusstring required
marketing_sourcestring nullable
created_datestring nullable required
updated_datestring nullable required
status_updated_datestring nullable required
tagsstring[] nullable
social_dict_listobject[] nullable
is_convertedboolean

Whether lead has been converted to contact

contact_idstring nullable

Contact ID if converted

has_dealboolean

Whether a deal/opportunity exists

deal_stagestring nullable

Current deal stage if exists

deal_idstring nullable

Deal/Opportunity ID if exists

value_of_salenumber nullable

Value of sale for the deal if exists

close_datestring nullable

Close date of the deal in ISO 8601 format

Changes

  • 165a6d16a9a0Revision changes
    • breaking

      removed the required property / from the response with the status

    • info

      added the new optional query request parameter end_date

    • info

      added the new optional query request parameter start_date

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      response property items/email_list list-of-types was narrowed by removing types string from media type application/json of response 200

    • info

      response property items/phone_list list-of-types was narrowed by removing types string from media type application/json of response 200

    • info

      added the required property / to the response with the status