Skip to main content
POST
cURL

Overview

The List Generation API lets you build targeted company lists using structured filters — applying specific criteria like company type, location, funding stage, or industry to filter companies. Results are ranked by akta.pro relevance by default.
The List Generation API is available on Subscription and Enterprise plans only. It is not included in the Pay-as-you-go plan. See Pricing for plan details.

Endpoint Details

  • Method: POST
  • Endpoint: /api/v1/list/generate/companies/

Authentication requirements

  • Include a valid API key in the x-api-key request header.

Request

Request Parameters

Header Parameters

string
required
Your API key.

Body Parameters

object
required
Structured filter conditions describing your target companies.

Available Filters

Note: funding_detail.* filters require an Enterprise plan. Requesting them on other plans will not return the expected data.
Filters from different groups can be combined in a single request. All conditions are combined with AND logic. A company must match every specified filter to be included in the results. The example below combines a firmographic filter, a location filter, a financial estimate range filter, a technology boolean filter, a business model filter, and an Enterprise-only funding detail nested filter:
string
Field to sort results by.Available values: relevance (default), revenue_estimate, valuation_estimate, employee_range, total_funding, founded_year
string
Sort direction.Available values: asc, descDefault = desc
integer
Maximum number of companies to return.Default = 50Max value = 500
integer
Number of results to skip for pagination.Default = 0

Response

Successful Response Fields

array
List of matching company objects. Each object includes identity fields only: uuid, name, website, product_category, company_type.
integer
Number of companies returned in this response.
integer
Total number of companies matching your filters. Capped at 500.
float
Number of credits consumed by this request.

Authorizations

x-api-key
string
header
required

API key obtained from your Akta account.

Body

application/json
filters
object
required

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

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 (Enterprise), mna_and_investment (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
limit
integer

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

offset
integer

Number of results to skip for pagination. Default: 0

Response

Successful response

data
object[]
count
integer

Number of companies returned.

total_count
integer

Total matching companies. Capped at 500.

credits_consumed
number<float>

Credits consumed. Returns 0 when no enrichment sections requested.