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

# Filter Builder

> Convert a natural-language description of target companies into structured filters for list generation.

Convert a natural-language description of your target companies into the structured `filters` object accepted by [`post_akta_list_generate`](/docs/api-reference/akta/post_list-generate-companies). "series a companies in mumbai working in climate tech" becomes `location.hq.city: ["Mumbai"]`, `funding_detail.funding_overview.funding_stage: ["series_a"]`, `industry.industry: [...]` — with the industry codes resolved for you.

Returns no companies itself. Costs the same \$0.025 as the natural-language surcharge on list generation, but the output is reviewable, tweakable, cacheable, and re-runnable with `filters`.

<Note>
  **First time?** Point any MCP client at `https://mcp.aisa.one/mcp` — Claude
  Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client
  opens a browser, you click Allow once, and there is no key to paste. The
  commands per client, and what each call costs, are on
  [aisa.one/mcp](https://aisa.one/mcp#connect).
</Note>

[Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/akta/post_list-filter-builder)


## OpenAPI

````yaml openapi/akta.json POST /list/filter-builder
openapi: 3.0.1
info:
  title: Akta Private Market Data API
  description: >-
    Private company intelligence: enrich 20M+ companies across 16 sections
    (firmographics, funding rounds, M&A, financial estimates, management, and
    more), build targeted company lists from structured filters or natural
    language, and resolve companies and industries from free text.
  version: 1.0.0
servers:
  - url: https://api.aisa.one/apis/v1/akta
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: Company Data
    description: >-
      Enrich a single company by section: firmographics, funding, M&A,
      financials, management
  - name: Company Discovery
    description: Build targeted company lists from structured filters or natural language
  - name: Supporting
    description: Entity resolution for companies and industries
paths:
  /list/filter-builder:
    post:
      tags:
        - Company Discovery
      summary: Build structured filters
      description: >-
        Convert a natural-language description of target companies into a
        structured filters object for list generation. Reviewable, tweakable,
        and reusable — costs the same $0.025 as the natural-language surcharge
        but the output can be cached and re-run. Returns no companies itself.
      operationId: post_akta_filter_builder
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - query
              properties:
                query:
                  type: string
                  description: e.g. 'series a companies in mumbai working in climate tech'.
      responses:
        '200':
          description: Structured filters object.
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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