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

# List company filter values

> The values the company search filters take. Without `field`, one list per filter: `industries` for `industriesV2`, `linkedinIndustries` for `linkedinIndustries`, `crunchbaseIndustries` for `crunchbaseCategories`, `crunchbaseCategoryGroups` for `crunchbaseCategoryGroups`, `companyTags` for `tags`, `naicsCodes[].code` for `naicsCodes`, `countries[].apiCode` for `headquartersCountryCode` and `officeLocationsV2`, `accelerators[].acceleratorSlug` for `acceleratorsV2`, `fundingStages` for `stage`, `technologies` for `technologies`, `statuses` for `status` and `fortuneRankings` for `fortuneRankings`. Copy values exactly: they are case-sensitive.

With `field`, that filter's entry, shaped as the people filters' are. Company names and places come from `GET /v1/companies/autocomplete`.

Free. **Scope:** search. Read-only keys may call it.



## OpenAPI

````yaml /openapi.json get /v1/companies/filters
openapi: 3.1.0
info:
  title: outbound.dev API
  version: v1
  description: Find people and companies, and see what every call costs, with one API key.
servers:
  - url: https://api.outbound.dev
security: []
tags:
  - name: People
    description: >-
      Search people with filters, a saved search or a plain-language query,
      count matches and look up filter values.
  - name: Companies
    description: >-
      Search companies, count matches, name one company by its name, domain or
      LinkedIn page, and list its people.
  - name: Saved searches
    description: Keep a search under a title and run it again, for people or for companies.
  - name: Jobs
    description: >-
      Long tasks a call started: their progress, what they produced and what
      they were charged.
  - name: Account
    description: >-
      The calling key and its organization, its rate limits, and revoking the
      key.
  - name: Billing
    description: The balance, the ledger of every change to it, and the price list.
  - name: Usage and requests
    description: >-
      Calls and spend by day, and the record of every request of the last 30
      days.
paths:
  /v1/companies/filters:
    get:
      tags:
        - Companies
      summary: List company filter values
      description: >-
        The values the company search filters take. Without `field`, one list
        per filter: `industries` for `industriesV2`, `linkedinIndustries` for
        `linkedinIndustries`, `crunchbaseIndustries` for `crunchbaseCategories`,
        `crunchbaseCategoryGroups` for `crunchbaseCategoryGroups`, `companyTags`
        for `tags`, `naicsCodes[].code` for `naicsCodes`, `countries[].apiCode`
        for `headquartersCountryCode` and `officeLocationsV2`,
        `accelerators[].acceleratorSlug` for `acceleratorsV2`, `fundingStages`
        for `stage`, `technologies` for `technologies`, `statuses` for `status`
        and `fortuneRankings` for `fortuneRankings`. Copy values exactly: they
        are case-sensitive.


        With `field`, that filter's entry, shaped as the people filters' are.
        Company names and places come from `GET /v1/companies/autocomplete`.


        Free. **Scope:** search. Read-only keys may call it.
      operationId: getCompaniesFilters
      parameters:
        - name: field
          in: query
          required: false
          description: >-
            One filter's values, by the filter's name. Without it, every
            filter's.
          schema:
            type: string
            minLength: 1
            maxLength: 100
      responses:
        '200':
          description: The values the company search filters take.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Charged-Usd:
              $ref: '#/components/headers/ChargedUsd'
            X-Balance-Usd:
              $ref: '#/components/headers/BalanceUsd'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  fields:
                    type: object
                    description: 'With `field`: that filter''s entry, by its name.'
                    additionalProperties:
                      type: object
                      required:
                        - valueShape
                        - values
                      properties:
                        valueShape:
                          type: string
                          enum:
                            - include_exclude
                            - term
                            - range
                            - date_range
                          description: >-
                            How the filter takes values: `include_exclude`
                            entries, plain `term`s, or a range.
                        values:
                          type: array
                          description: >-
                            The values the filter accepts. Empty for a free-text
                            filter.
                          items:
                            type: object
                            required:
                              - label
                              - value
                            properties:
                              label:
                                type: string
                              value:
                                type: string
                        autocomplete:
                          type: string
                          description: >-
                            A free-text filter's suggestions route: add `&q=`
                            and the text typed.
                  industries:
                    type: array
                    description: The values of the `industriesV2` filter.
                  linkedinIndustries:
                    type: array
                    description: The values of the `linkedinIndustries` filter.
                  countries:
                    type: array
                    description: >-
                      Countries: each one's `apiCode` is a value of
                      `headquartersCountryCode`.
                  fundingStages:
                    type: array
                    description: The values of the `stage` filter.
                  statuses:
                    type: array
                    description: The values of the `status` filter.
                  technologies:
                    type: array
                    description: The values of the `technologies` filter.
              example:
                industries:
                  - Logistics
                  - Freight
                fundingStages:
                  - seed
                  - series_a
                statuses:
                  - active
        '429':
          $ref: '#/components/responses/RateLimited'
        4XX:
          $ref: '#/components/responses/Error'
        5XX:
          $ref: '#/components/responses/ServerError'
      security:
        - apiKey: []
components:
  headers:
    RequestId:
      description: The request's id. Quote it when you write to support.
      schema:
        type: string
        example: req_6a1f0c2b9d4e8a7f3c5b2e10
    ChargedUsd:
      description: What this call cost, in US dollars as an exact six-decimal string.
      schema:
        type: string
        example: '0.000500'
    BalanceUsd:
      description: >-
        The organization's balance after this call, in US dollars as an exact
        six-decimal string.
      schema:
        type: string
        example: '9.999500'
    RateLimitLimit:
      description: >-
        The calls allowed in the window of the route's limit with the fewest
        calls left.
      schema:
        type: integer
        example: 20
    RateLimitRemaining:
      description: The calls left in that window.
      schema:
        type: integer
        example: 19
    RateLimitReset:
      description: Seconds until that window resets.
      schema:
        type: integer
        example: 42
    RetryAfter:
      description: Seconds to wait before calling again.
      schema:
        type: integer
        example: 42
  responses:
    RateLimited:
      description: >-
        Too many calls. Wait the seconds in Retry-After, then call again. The
        body is empty.
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
    Error:
      description: The request was refused. The body names the reason in `error.code`.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: >-
        Something failed on our side and nothing was charged. Retry with
        backoff; quote X-Request-Id if it persists. The body is empty.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - doc_url
          properties:
            code:
              type: string
              description: >-
                Stable and machine-readable: branch on it. It never changes
                meaning.
            message:
              type: string
              description: >-
                A human-readable explanation for logs. It may be reworded at any
                time.
            param:
              type: string
              description: The request field the error is about, when there is one.
            doc_url:
              type: string
              description: The code's entry in the errors reference.
            request_id:
              type: string
              description: >-
                The request's id, as in the X-Request-Id header. Quote it to
                support.
      example:
        error:
          code: insufficient_balance
          message: Your balance cannot cover this call. Add funds and try again.
          doc_url: https://docs.outbound.dev/errors#insufficient_balance
          request_id: req_6a1f0c2b9d4e8a7f3c5b2e10
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An API key from the console, starting `ob_live_`, sent as
        `Authorization: Bearer <key>`.

````

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