Skip to main content
POST
List Generation
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 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).
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. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent → See Pricing for current prices. Where supported, get a quote for your request.

Request contract

  • Method and path: POST /apis/v1/akta/list/generate/companies
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/akta/list/generate/companies
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.05 USD per successful request. Your account price may differ; use a request quote where supported.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
filters
object

Structured filter conditions. Use the Filter Builder API to generate valid filters. Cannot be used with query. See filter options at /api-reference/listgen-api.

limit
integer

Maximum companies to return. Default: 50, Max: 500

offset
integer

Number of results to skip for pagination. Default: 0

query
string

Natural language search query (e.g. 'SaaS companies in the US with Series A funding'). Cannot be used with filters.

sections
string[]

Data enrichment sections to include. Values: firmographic, business_model, company_assessment, trust_signal, company_hierarchy, digital_presence, financial_estimate, location, management_profile, product_offering, strategic_signal, customer_profile, industry, technology, funding_detail (Subscription, Enterprise), mna_and_investment (Subscription, Enterprise)

sort_by
enum<string>

Field to sort results by. Default: relevance

Available options:
relevance,
revenue_estimate,
valuation_estimate,
employee_range,
total_funding,
founded_year
sort_order
enum<string>

Sort direction. Default: desc

Available options:
asc,
desc

Response

Successful response

count
integer

Number of companies returned.

credits_consumed
number<float>

Credits consumed. Returns 0 when no enrichment sections requested.

data
object[]
total_count
integer

Total matching companies. Capped at 500.