---
title: "Typeahead Search"
method: GET
path: "/search/typeahead"
tags: ["companies", "people", "search"]
---

# Typeahead Search

`GET /search/typeahead`

## Query parameters

- `query` string, required
- `search_type` 'PERSON' | 'COMPANY' | 'SCHOOL' | 'EMAIL_INTEGRATED_USER' | 'INVESTOR' | 'INVESTOR_COMPANY' | 'INVESTOR_PERSON' | 'LOCATION' | 'LOCATION_CITY' | 'LOCATION_STATE' | 'LOCATION_COUNTRY' | 'LOCATION_METRO_AREA'
- `source` 'ENTERPRISE_APP'
- `page` integer — Page number
- `size` integer — Page size

## Response `200`

Successful Response

- TypeaheadSearchOutput
  - `count` integer, nullable
  - `total_count` integer, nullable
  - `results` TypeaheadEntity[], required
    - `entity_urn` union, required
      - string
      - string
      - string
      - string
      - string
      - string
      - string
    - `type` 'PERSON' | 'COMPANY' | 'SCHOOL' | 'EMAIL_INTEGRATED_USER' | 'INVESTOR' | 'INVESTOR_COMPANY' | 'INVESTOR_PERSON' | 'LOCATION' | 'LOCATION_CITY' | 'LOCATION_STATE' | 'LOCATION_COUNTRY' | 'LOCATION_METRO_AREA', required
    - `source` 'ENTERPRISE_APP', required
    - `text` string, nullable
    - `alt_text` string, nullable
    - `index_field` string, nullable
    - `index_id` string, nullable
    - `ranking_score` number, nullable
    - `index_method` 1 | 2
    - `subtype` 'COMPANY' | 'PERSON' | 'CITY' | 'STATE' | 'COUNTRY' | 'METRO_AREA'

## Other responses

- `422` — Validation Error

## Changes

> 11 revisions in range; 5 could not be searched.

- **2026-07-26** `fcf35c98e097` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/changes/search/typeahead/get.md)

---

[API](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api.md) · [All operations](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/harmonic/harmonic-ai-public-api/revisions/6b871b842c2d/schema)