> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fuseai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suggest values for a free-text search field

> Type-ahead vocabulary for the free-text people filters — `company`, `website`, `location`, `region`, `title`, `school`, `skill` — the same suggestions the product's search UI offers. Send the returned `name` verbatim as the filter value; the values are lower-cased exactly as the provider stores them. The enum-backed fields are served in full by GET /prospects/filter-options instead. Only `field=region` rows carry `countries`, listing the countries that region name appears in, likeliest first, so identically named regions can be told apart. Free: no credits, no provider spend beyond the type-ahead call.

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: search.



## OpenAPI

````yaml /openapi.json get /business/prospects/autocomplete
openapi: 3.1.0
info:
  title: Fuse Business API
  version: 1.0.0
  description: >-
    External API for lists, campaigns, prospect search and contacts.
    Authenticate with your API token as HTTP Basic. All paths are under /api/v1.
servers:
  - url: https://api.tryfuse.ai/api/v1
    description: Production
security:
  - basicAuth: []
tags:
  - name: Lists
  - name: Custom columns
  - name: Smart columns
  - name: Exports
  - name: Campaigns
  - name: Knowledge hubs
  - name: Analytics
  - name: Website intent
  - name: Account
  - name: Prospect search
  - name: Campaign steps
  - name: Scheduled sends
  - name: Campaign templates
  - name: Agents
  - name: Research
  - name: Company search
  - name: Saved searches
  - name: Folders
  - name: Contacts
paths:
  /business/prospects/autocomplete:
    get:
      tags:
        - Prospect search
      summary: Suggest values for a free-text search field
      description: >-
        Type-ahead vocabulary for the free-text people filters — `company`,
        `website`, `location`, `region`, `title`, `school`, `skill` — the same
        suggestions the product's search UI offers. Send the returned `name`
        verbatim as the filter value; the values are lower-cased exactly as the
        provider stores them. The enum-backed fields are served in full by GET
        /prospects/filter-options instead. Only `field=region` rows carry
        `countries`, listing the countries that region name appears in,
        likeliest first, so identically named regions can be told apart. Free:
        no credits, no provider spend beyond the type-ahead call.


        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: search.
      operationId: autocompleteProspectSearchField
      parameters:
        - name: field
          in: query
          required: true
          description: >-
            Which free-text vocabulary to suggest from: `company`, `website`,
            `location`, `region`, `title`, `school` or `skill` (`region`
            suggestions also carry the `countries` they appear in).
          schema:
            type: string
            enum:
              - company
              - website
              - location
              - region
              - title
              - school
              - skill
            description: >-
              Which free-text vocabulary to suggest from: `company`, `website`,
              `location`, `region`, `title`, `school` or `skill` (`region`
              suggestions also carry the `countries` they appear in).
        - name: q
          in: query
          required: true
          description: Text fragment to complete (1-100 chars).
          schema:
            type: string
            minLength: 1
            maxLength: 100
            description: Text fragment to complete (1-100 chars).
      responses:
        '200':
          description: Success
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Requests permitted in the current window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets.
          content:
            application/json:
              schema:
                type: object
                required:
                  - field
                  - suggestions
                properties:
                  field:
                    type: string
                    enum:
                      - company
                      - website
                      - location
                      - region
                      - title
                      - school
                      - skill
                    description: Echo of the requested field.
                  suggestions:
                    type: array
                    items:
                      type: object
                      required:
                        - name
                      properties:
                        name:
                          type: string
                          description: The canonical value to send as the filter value.
                        countries:
                          type: array
                          items:
                            type: string
                          description: >-
                            Only on `field=region` rows: the countries this
                            region name appears in, likeliest first.
              example:
                field: region
                suggestions:
                  - name: california
                    countries:
                      - united states
                  - name: baja california
                    countries:
                      - mexico
                  - name: baja california sur
                    countries:
                      - mexico
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - basicAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            param:
              type:
                - string
                - 'null'
            doc_url:
              type:
                - string
                - 'null'
            request_id:
              type:
                - string
                - 'null'
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Your API token (`af_…`) as the Basic-auth username, with an empty
        password.

````