---
title: "Search people"
method: GET
path: "/search/people"
tags: ["Search People"]
---

# Search people

`GET /search/people`

Returns a list of people that match the provided filters. Searches across candidates and client contacts. You can search by full name, email address, or phone number. Results use fuzzy matching for partial matches and minor typos, ranked by relevance.

## Query parameters

- `query` string, required
- `limit` integer

## Response `200`

Successfully retrieved matching people. Returns a list of candidates and client contacts matching the search query.

- TenantWidePeopleEntitiesDto
  - `items` TenantWidePeopleItemDto[], required
    - union
      - object
        - `entityType` 'candidate', required
        - `id` string, required
        - `firstName` string, required
        - `middleName` string, nullable, required
        - `lastName` string, required
        - `secondLastName` string, nullable, required
        - `avatarUrl` string, nullable, required
        - `phoneNumbers` string[], nullable, required
        - `emailAddresses` string[], nullable, required
        - `linkedInUrl` string, nullable, required
      - object
        - `entityType` 'clientContact', required
        - `id` string, required
        - `candidateId` string, required
        - `firstName` string, required
        - `middleName` string, nullable, required
        - `lastName` string, required
        - `secondLastName` string, nullable, required
        - `avatarUrl` string, nullable, required
        - `companyId` string, required
        - `companyName` string, required
        - `companyLogoUrl` string, nullable, required
        - `phoneNumbers` string[], nullable, required
        - `emailAddresses` string[], nullable, required
        - `linkedInUrl` string, nullable, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - invalid or missing authentication
- `500` — Error response

---

[API](https://skmtc.net/spott/apis/spott-webhooks.md) · [All operations](https://skmtc.net/spott/apis/spott-webhooks/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spott/spott-webhooks/versions/ad1f8c51cf0a/schema)