v1

latestOpenAPI 3.1.02026-08-069158174.8 KB
CRM Service Calls

Get Contacts Status Updated

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

Returns contacts where status_update_date falls within the specified range. Defaults to the last 60 minutes (UTC) when no dates are provided.

Time-based filtering (start_date / end_date):

  • Format: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
  • Default window (no params): last 1 hour

Example requests:

  • Status changes in the last 1 hour (default): GET /contacts/status_updated
  • Status changes in the last 7 days: GET /contacts/status_updated?start_date=2026-03-22&end_date=2026-03-29
  • Only "meeting-setup" contacts since yesterday: GET /contacts/status_updated?start_date=2026-03-28&match_filter_dict={"status": "meeting-setup"}

Other Query Parameters:

  • match_filter_dict (optional): JSON-encoded MongoDB filter for non-date fields. Example: {"status": "meeting-setup"}

Response: Array of contact objects (same schema as GET /contacts).

get/crm/contacts/status_updated

Query parameters

match_filter_dictstring
start_datestring nullable

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

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.

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