---
title: "Suggest values for company and location filters"
method: GET
path: "/business/companies/autocomplete"
tags: ["Company search"]
---

# Suggest values for company and location filters

`GET /business/companies/autocomplete`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/companies/autocomplete`
- Auth: HTTP basic

Resolves free-text input to canonical company-filter values; two characters minimum. `field=company` returns company names with their `domain` when known — send `name` to `nameLike`, or `domain` to `domains`; add `orgType=investor` to search investors instead, whose `domain` is the value the `investors` filter takes. `field=location` returns fully qualified place names ("Dallas, Texas, United States") which are exactly what the `headquartersCity` filter takes — the qualification is what lets the geocoder tell six same-named cities apart, so send the whole string. Note that `officeLocationsV2` is a different filter and takes country `apiCode`s from GET /companies/filter-options, not these place names. Same vocabulary as the product's type-ahead; free.

Errors:
- `422` `VALIDATION_FAILED` — The request failed the declared schema; `param` names the offending key and `message` quotes the rule it broke.
- `429` `RATE_LIMITED` — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.
- `500` `UNEXPECTED_ERROR` — The request failed inside the service; nothing was billed and the request_id identifies the failure.

Requires one of the following token scopes: companies.

## Query parameters

- `field` 'company' | 'location', required: `company` suggests company names (each with its `domain` when known); `location` suggests fully qualified place names (e.g. Dallas, Texas, United States) to send as `headquartersCity` values.
- `q` string, required: Text fragment to complete (2-200 chars).
- `orgType` 'investor': `investor` narrows `field=company` to investors, for the `investors` filter; not allowed with `field=location`.

## Response `200`

Success

- object
  - `field` 'company' | 'location', required: Echo of the requested field.
  - `suggestions` object[], required
    - `name` string, required: For `field=company` the company name; for `field=location` the fully qualified place name to send as a `headquartersCity` value.
    - `domain` string: `field=company` only, and only when the provider has one.

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)