Crono icon

Crono

Consume the Crono Public API

Contact → Search

AI-generated

Summary

Search for contacts in the Crono Public API with flexible criteria, supporting both structured fields and raw JSON search payloads.

Inputs

  • API Version — Specify the version of the Crono Public API, defaults to '1'.
  • Use Raw JSON — Choose whether to send a raw JSON search payload instead of using individual search fields.
  • Search (JSON) — Provide a raw JSON search request body for custom queries; used only if 'Use Raw JSON' is enabled.
  • Return All — Choose whether to return all matching contacts or limit the result set.
  • Additional Fields — Add arbitrary custom search fields to merge into the search payload.
  • Name — Filter contacts by name.
  • Title — Filter contacts by title.
  • Object IDs — Comma-separated list of specific contact object IDs to filter by.
  • User ID — Filter contacts by owner user ID.
  • Limit — Maximum number of contacts to return, active if 'Return All' is false.
  • Offset — Number of contacts to skip before starting to return results.
  • Company External Properties (JSON) — Provide JSON filters for company external properties.
  • Company External Property Empty IDs — Comma-separated list of company external property IDs where values should be empty.
  • Company External Property Numeric Filters (JSON) — Numeric filters for company external properties in JSON format.
  • Company ID — Filter contacts by related company ID.
  • Company Status — Filter contacts by associated company status.
  • Actual Status — Filter contacts by their actual status.
  • Country — Filter contacts by country.
  • Created Date Min — Filter contacts created after this date/time.
  • Created Date Max — Filter contacts created before this date/time.
  • Current Solution — Filter by current solution specified on the contact.
  • External Properties (JSON) — Filter contacts using JSON external property criteria.
  • External Property Empty IDs — Comma-separated list of external property IDs to match empty values.
  • External Property Numeric Filters (JSON) — Numeric filters for external properties in JSON format.
  • From Contact — Boolean filter for contacts marked as 'from contact'.
  • Has Active Tasks — Boolean filter to select contacts having active tasks.
  • Has Activities — Boolean filter to select contacts having activities.
  • Has Clicked Links — Boolean filter to select contacts who clicked links.
  • Has Connected Calls — Boolean filter to select contacts with connected calls.
  • Has Email Address — Boolean filter to select contacts with an email address.
  • Has Emails Opened — Boolean filter for contacts who opened emails.
  • Has LinkedIn Url — Boolean filter for contacts that have a LinkedIn URL.
  • Has Mobile Phone — Boolean filter for contacts that have a mobile phone number.
  • Has Phone — Boolean filter for contacts that have a phone number.
  • Has Replies — Boolean filter to select contacts with replies.
  • In Sequence — Boolean filter for contacts currently in a sequence.
  • Industry — Filter contacts by industry.
  • Is Phone Valid — Boolean filter for phone number validity.
  • Last Activity Date Min — Filter contacts with last activity after this date/time.
  • Last Activity Date Max — Filter contacts with last activity before this date/time.
  • Last Modified Date Min — Filter contacts modified after this date/time.
  • Last Modified Date Max — Filter contacts modified before this date/time.
  • Location — Filter contacts by location.
  • No User — Boolean filter to select contacts without an assigned user.
  • Number Of Employees Min — Filter for contacts associated with companies having at least this number of employees.
  • Number Of Employees Max — Filter for contacts associated with companies having at most this number of employees.
  • Opted Out — Boolean filter for contacts opted out.
  • LinkedIn Status — Filter contacts by LinkedIn connection status related to the owner.
  • Sort — Choose sort order for returned contacts.
  • Verification Statuses — Filter contacts by their verification statuses.

Output shape

a list of contacts matching the search criteria

If 'Return All' is false, results are limited by 'Limit' and 'Offset' fields. If 'Use Raw JSON' is enabled, the raw JSON 'search' payload determines the query. The response includes contact records as per Crono API v1 response format.

Links

Discussion