The search records endpoint provides a convenient way to fuzzy search for records across one or more objects. The matching strategy employed in this endpoint follows the in-product strategy and will match names, domains, emails, phone numbers and social handles on people and companies, and labels on all other objects. Please note, results returned from this endpoint are eventually consistent. For results which are guaranteed to be up to date, please use the record query endpoint instead.

This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.

Required scopes: record_permission:read, object_configuration:read.

Supported token levels: workspace, user.

{
  "query": "alan mathis",
  "limit": 25,
  "objects": [
    "people",
    "deals",
    "1b31b79a-ddf9-4d57-a320-884061b2bcff"
  ],
  "request_as": {
    "workspace_member_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
  }
}

{
  "data": [
    {
      "id": {
        "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
        "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
        "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b"
      },
      "record_text": "Alan Mathison Turing",
      "record_image": "https://cdn.image-service.com/images/profiles/e67b8980-7dbb-46bf-95e3-266d7bceb096",
      "object_slug": "applications"
    }
  ]
}