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:
- Name only
- Phone only
- 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