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

# List Generation

> Build targeted company lists from structured filters or natural language, with optional enrichment.

Build a targeted company list from structured `filters` or a natural-language `query`, with optional per-section enrichment on every returned company. This is deal sourcing: "Series A fintechs in Singapore", "bootstrapped HR-tech companies in Europe with 50-200 employees" — expressed as filters, run repeatedly.

Prefer [`post_akta_filter_builder`](/docs/api-reference/akta/post_list-filter-builder) to turn plain language into a reviewable `filters` object first; pass `query` directly only for one-shot searches (it carries a surcharge and is not reproducible).

Pricing: base $0.05 per call (+$0.10 with `query`) + \$0.02 per returned company + per-section enrichment costs × company count.

<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-generate-companies)


## OpenAPI

````yaml openapi/akta.json POST /list/generate/companies
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/generate/companies:
    post:
      tags:
        - Company Discovery
      summary: Generate a company list
      description: >-
        Build a targeted company list from structured filters or a
        natural-language query, with optional per-section enrichment. Use
        filter-builder first to turn plain language into a reviewable filters
        object, then pass it here. Pricing: base $0.05 + $0.40 per returned
        company when enrichment sections are requested.
      operationId: post_akta_list_generate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: >-
                    Natural-language description of target companies (adds $0.10
                    surcharge; prefer filters for repeatability).
                filters:
                  type: object
                  description: >-
                    Structured filters from filter-builder (dotted-path keys,
                    e.g. location.hq.city,
                    funding_detail.funding_overview.funding_stage,
                    industry.industry).
                sections:
                  type: array
                  items:
                    type: string
                  description: >-
                    Optional enrichment sections per returned company (same
                    section names as company enrichment).
                limit:
                  type: integer
                  description: Max companies to return (total capped at 500).
                offset:
                  type: integer
      responses:
        '200':
          description: Matching companies with optional enrichment.
          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.