Get Contacts Status Updated
Changed onRetrieve 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).
Request
- Base URLhttps://fapi.ambivo.com (the document declares no server; this is the origin it was published from)
- AuthAPI key in header Authorization
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Start of date range in ISO 8601 format. Defaults to now − 1 hour.
End of date range in ISO 8601 format. Defaults to now.
Response
Successful Response
Changes
- info
added the new optional
queryrequest parameterend_date - info
added the new optional
queryrequest parameterstart_date - 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_listlist-of-types was narrowed by removing typesstringfrom media typeapplication/jsonof response200 - info
response property
items/phone_listlist-of-types was narrowed by removing typesstringfrom media typeapplication/jsonof response200
- info