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

# Company Field Values

> Lists the most frequent values of one company search field.



## OpenAPI

````yaml /openapi.json post /v1/companies/search/field-values
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for people and companies: research agents that investigate,
    resolve identities, map relationships and surface risk signals.
  contact:
    name: Sixtyfour
    url: https://sixtyfour.ai/
    email: support@sixtyfour.ai
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sixtyfour.ai
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - name: Search
    description: Run deep and filter searches over Sixtyfour's data.
  - name: Workflow
    description: Create, run, and manage enrichment workflows.
  - name: Workflow Schedules
    description: Create and manage recurring schedules for workflows.
  - name: Account
    description: Manage and inspect your account and credit balance.
  - name: Feedback
    description: >-
      Tell us a result was wrong, missing or outdated, and report problems with
      the API, the docs or a tool.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Start, continue and read Atlas investigations: attribution graph,
      workspace files, reports and exports.
paths:
  /v1/companies/search/field-values:
    post:
      tags:
        - Search
      summary: Company Field Values
      description: Lists the most frequent values of one company search field.
      operationId: company_field_values_v1_companies_search_field_values_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FieldValuesRequest'
            example:
              field: industry
              max_results: 10
        required: true
      responses:
        '200':
          description: Common values for the requested company search field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FieldValuesResponse'
              example:
                mode: company
                field: industry
                canonical_field: industry
                value_type: keyword
                supports_top_values: true
                supports_exact_filter_snippet: true
                total_scoped_documents: 0
                items: []
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobValidationError'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Service Unavailable
components:
  schemas:
    FieldValuesRequest:
      properties:
        field:
          type: string
          maxLength: 200
          minLength: 1
          title: Field
          description: >-
            Search field whose values to list. Use a field returned by the
            fields endpoint.
        max_results:
          type: integer
          maximum: 100
          minimum: 1
          title: Max Results
          description: 'Maximum values to return. Default: 25. Range: 1 to 100.'
          default: 25
        filters:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Filters
          description: >-
            Filters to apply before counting values. Omit to count all matching
            records.
      additionalProperties: false
      type: object
      required:
        - field
      title: FieldValuesRequest
      examples:
        - field: industry
          max_results: 10
    FieldValuesResponse:
      properties:
        mode:
          type: string
          enum:
            - people
            - company
          title: Mode
          description: '`people` or `company`.'
          default: company
        field:
          type: string
          title: Field
          description: Field requested by the caller.
        canonical_field:
          type: string
          title: Canonical Field
          description: Canonical field path used for aggregation.
        nested_path:
          anyOf:
            - type: string
            - type: 'null'
          title: Nested Path
          description: Nested path, if any.
        value_type:
          type: string
          title: Value Type
          description: Aggregation target type (keyword, long, etc.).
        supports_top_values:
          type: boolean
          title: Supports Top Values
          description: Whether this field supports top-values aggregation.
        supports_exact_filter_snippet:
          type: boolean
          title: Supports Exact Filter Snippet
          description: Whether the response includes deterministic filter snippets.
        related_fields:
          items:
            type: string
          type: array
          title: Related Fields
          description: >-
            Other field paths representing the same concept (e.g. flat
            counterpart of nested).
        preferred_for_exact_match:
          type: boolean
          title: Preferred For Exact Match
          description: >-
            Recommended for simple exact-match queries over its nested
            counterpart.
          default: false
        total_scoped_documents:
          type: integer
          title: Total Scoped Documents
          description: Total documents matched by the scoped query.
        items:
          items:
            $ref: '#/components/schemas/FilterFieldValuesValue'
          type: array
          title: Items
          description: Field values ordered by frequency.
      type: object
      required:
        - field
        - canonical_field
        - value_type
        - supports_top_values
        - supports_exact_filter_snippet
        - total_scoped_documents
      title: FieldValuesResponse
    PublicJobError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
      title: PublicJobError
    PublicJobValidationError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
        errors:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Errors
          description: >-
            Individual validation failures, each with a parameter location
            (`loc`), message (`msg`), and error type (`type`).
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
        - errors
      title: PublicJobValidationError
    FilterFieldValuesValue:
      properties:
        value:
          anyOf:
            - type: string
            - type: integer
            - type: number
            - type: boolean
            - type: 'null'
          title: Value
          description: The value; `null` counts records without one.
        count:
          type: integer
          title: Count
          description: Document count for this value within the scoped query.
        percent_of_scope:
          type: number
          title: Percent Of Scope
          description: Share (0-1) of scoped documents matching this value.
        filter_snippet:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Filter Snippet
          description: Ready-to-merge filter clause that selects this value.
      type: object
      required:
        - count
        - percent_of_scope
      title: FilterFieldValuesValue
      description: One candidate value returned by field-values endpoints.
    V1ErrorCode:
      type: string
      enum:
        - invalid_cursor
        - request_in_progress
        - limit_exceeded
        - entity_type_mismatch
        - unsupported_file
        - invalid_upload
        - file_too_large
        - items_not_available
        - list_not_ready
        - job_not_finished
        - not_found
        - validation_error
        - rate_limited
        - internal_error
        - unavailable
        - unauthenticated
        - forbidden
        - insufficient_credits
        - idempotency_key_reused
        - export_source_changed
        - job_execution_changed
        - job_failed
        - item_failed
        - aborted
        - timed_out
      title: V1ErrorCode
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Sixtyfour API key.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OAuth access token from `POST /oauth/token`, sent as `Authorization:
        Bearer <token>`. An API key sent as a bearer token is refused with 401.
        When both headers are sent, the bearer token is used.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.