> ## 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.

# Distinct values a company list carries for a field

> The distinct values a company list carries for one company field — `name` (company names) or `domain` (web domains) — for building row filters or exclusion sets. Values are returned as a flat, de-duplicated array; a contact list answers an empty array.

Errors:
- `404` `LIST_NOT_FOUND` — No list with that id is visible to the token owner.
- `422` `VALIDATION_FAILED` — field missing or not name|domain.
- `429` `RATE_LIMITED` — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.



## OpenAPI

````yaml /openapi.json get /business/lists/{listId}/filter-values
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/lists/{listId}/filter-values:
    get:
      tags:
        - Lists
      summary: Distinct values a company list carries for a field
      description: >-
        The distinct values a company list carries for one company field —
        `name` (company names) or `domain` (web domains) — for building row
        filters or exclusion sets. Values are returned as a flat, de-duplicated
        array; a contact list answers an empty array.


        Errors:

        - `404` `LIST_NOT_FOUND` — No list with that id is visible to the token
        owner.

        - `422` `VALIDATION_FAILED` — field missing or not name|domain.

        - `429` `RATE_LIMITED` — The lists rate bucket is exhausted.


        Requires one of the following token scopes: lists.
      operationId: getListFilterValues
      parameters:
        - name: listId
          in: path
          required: true
          description: 24-character hex id of the list (from GET /business/lists).
          schema:
            type: string
            description: 24-character hex id of the list (from GET /business/lists).
        - name: field
          in: query
          required: true
          description: >-
            Which company field to collect distinct values for: name (company
            names, the vocabulary of the companyName row filter) or domain
            (company web domains, the vocabulary of the website row filter).
            Values come from the COMPANY rows of the list, so a contact list
            answers with an empty array.
          schema:
            type: string
            enum:
              - name
              - domain
            description: >-
              Which company field to collect distinct values for: name (company
              names, the vocabulary of the companyName row filter) or domain
              (company web domains, the vocabulary of the website row filter).
              Values come from the COMPANY rows of the list, so a contact list
              answers with an empty array.
      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
                  - values
                properties:
                  field:
                    type: string
                    enum:
                      - name
                      - domain
                  values:
                    type: array
                    items:
                      type: string
              example:
                field: domain
                values:
                  - brightpay.com
                  - stripe.com
        '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.

````