Skip to main content
POST …/contacts/find Synchronously search for contacts within your organization. Returns a list of matching contacts with their contact details and contributors. This endpoint is synchronous — results are returned inline in the response.

Request


Body fields

At least one of full_name, phone_number, or contact_email is required. Providing none returns 400.

Matching logic

By default, Goliath uses strict matching — all provided fields must match the same contact. If match_any: true is set and strict matching returns no results, Goliath falls back to searching each field individually:
  1. Name only
  2. Phone only
  3. Email only
Results from the first successful fallback are returned.
match_any also accepts the string "true" (case-insensitive) for integrations that serialize booleans as strings.

Response

Returns an empty array [] if no contacts match.

Error responses