---
title: "Autocomplete company fields"
method: POST
path: "/api/v1/autocomplete/company"
tags: ["Autocomplete"]
---

# Autocomplete company fields

`POST /api/v1/autocomplete/company`

## Request

- Base URL: `https://targetwise.ai`
- URL: `https://targetwise.ai/api/v1/autocomplete/company`
- Auth: HTTP bearer

Populate company form fields from a name, website or registration number. This resolves a company profile; it is not a typeahead suggestion list.

## Request body

- union
  - object
    - `name` string, required
    - `website_url` string, uri
    - `registration_number` string
    - `country_code` string
    - `include_provenance` boolean
  - object
    - `name` string
    - `website_url` string, uri, required
    - `registration_number` string
    - `country_code` string
    - `include_provenance` boolean
  - object
    - `name` string
    - `website_url` string, uri
    - `registration_number` string, required
    - `country_code` string
    - `include_provenance` boolean

## Response `200`

A normalized match, partial match or no-match result.

- object
  - `object` 'enrichment_result', required
  - `operation` 'company_autocomplete', required
  - `request_id` string, required
  - `status` 'matched' | 'partial' | 'not_found', required
  - `data` object, nullable, required
    - `company_id` string
    - `legal_name` string
    - `registration_number` string
    - `vat_number` string
    - `country_code` string
    - `country_name` string
    - `status` string
    - `legal_form` string
    - `founded_on` string
    - `employee_count` union
      - string
      - number
    - `brands` string
    - `website` string
    - `company_emails` string[]
    - `company_phones` string[]
    - `address` object
      - `street` string
      - `line_2` string
      - `city` string
      - `region` string
      - `postal_code` string
    - `industries` string[]
    - `sic_codes` string[]
    - `linkedin_url` string
    - `twitter_url` string
    - `facebook_url` string
    - `provenance` object[]
      - `field` string
      - `source_path` string
      - `id` union
        - string
        - number
      - `category` string
      - `name` string
      - `url` string
      - `comment` string
  - `unresolved_fields` string[], required
  - `grounding` object, required
    - `retrieved_at` string, date-time, required
    - `source_provenance` 'included' | 'not_available', required

## Other responses

- `400`: Invalid request or operation_pricing_unavailable. Adding credit does not enable an unpriced operation.
- `401`: A valid TargetWise bearer key is required.
- `402`: Free allowance or paid balance exhausted, or usage_budget_reached. A top-up does not increase the monthly usage budget.
- `403`: The workspace is inactive or access is restricted.
- `409`: Workspace usage could not be reserved. Inspect retryable before a bounded retry.
- `413`: The request body exceeds 64 KB.
- `415`: Use Content-Type: application/json.
- `429`: The workspace attempt/rate limit or provider limit has been reached.
- `500`: Unexpected internal error.
- `502`: The data connection returned an unusable response.
- `503`: The service or data connection is unavailable or unconfigured.
- `504`: The data connection timed out.

---

[API](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api.md) · [All operations](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api/revisions/bd436a05769d?raw)