> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.akta.pro/llms.txt
> Use this file to discover all available pages before exploring further.
# List Generation API
> Build targeted company lists using structured filters.
## 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](/getting-started/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
Your API key.
#### Body Parameters
Structured filter conditions describing your target companies.
#### Available Filters
| Field | Type | Accepted Values |
| --------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `firmographic.company_type` | string\[] | `private`, `public` |
| `firmographic.ownership_category` | string\[] | `corporate_owned`, `family_owned`, `founder_individual_operated_bootstrapped`, `management_employee_owned`, `nonprofit_foundation_owned`, `private_equity_controlled`, `public`, `state_government_owned`, `venture_growth_investor_backed` |
| `firmographic.operating_status` | string\[] | `acquired`, `closed`, `ipo`, `operating` |
| `firmographic.founded_year` | object | Range object. Accepts `gte` and/or `lte` (integer, four-digit year).
Eg. \{"gte": 2010, "lte": 2014 } |
| Field | Type | Accepted Values |
| ------------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `business_model.gtm_type` | string\[] | `b2b`, `b2b_and_b2c`, `b2c` |
| `business_model.offering_type` | string\[] | `digital_commerce_content`, `hardware_manufacturing`, `services`, `software` |
| `business_model.gtm_motion` | string\[] | `api_first`, `channel_partners`, `community_led`, `direct_to_consumer`, `enterprise_field_sales`, `event_driven`, `inside_sales`, `marketplace_listing`, `oem_embedded`, `product_led_growth`, `sales_led`, `others` |
| `business_model.revenue_model` | string\[] | `advertising`, `affiliate_referral`, `data_monetisation`, `freemium`, `grants_donations`, `hardware_sales`, `licensing_royalties`, `managed_services`, `marketplace_commission`, `one_time_license`, `professional_services`, `subscription_recurring`, `transaction_fee`, `usage_based` |
| Field | Type | Accepted Values |
| ---------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `company_assessment.customer_concentration.classification` | string\[] | `critical`, `high`, `low`, `moderate` |
| `company_assessment.competitive_moat` | string\[] | `cost_advantage`, `data_advantage`, `distribution_advantage`, `ecosystem_lock_in`, `efficient_scale`, `intangible_assets`, `network_effects`, `regulatory_moat`, `switching_costs`, `talent_moat` |
| Field | Type | Accepted Values |
| --------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `financial_estimate.revenue_estimate` | string\[] | `pre_revenue`, `under_1m`, `1m_5m`, `5m_10m`, `10m_25m`, `25m_50m`, `50m_100m`, `100m_250m`, `250m_500m`, `500m_1b`, `1b_5b`, `over_5b` |
| `financial_estimate.valuation_estimate` | string\[] | `under_10m`, `10m_50m`, `50m_100m`, `100m_250m`, `250m_500m`, `500m_1b`, `1b_5b`, `5b_10b`, `10b_25b`, `over_25b` |
| Field | Type | Accepted Values |
| ---------------------------------- | --------- | ----------------------------------------------------------------------------------------------------- |
| `location.hq.region` | string\[] | M49 region codes. Refer [here](/region-codes). |
| `location.hq.country` | string\[] | Any valid 3-letter ISO alpha-3 country code (e.g. `USA`, `IND`, `GBR`). Refer [here](/country-codes). |
| `location.hq.city` | string\[] | Free text — any city name (e.g. `delhi`) |
| `location.market_served.markets` | string\[] | Any valid 3-letter ISO alpha-3 country code (e.g. `USA`, `CHN`). Refer [here](/country-codes). |
| `location.market_served.is_global` | boolean | `true`, `false` |
| `location.offices.country` | string\[] | Any valid 3-letter ISO 3166-1 country code (e.g. `USA`, `DZA`). Refer [here](/country-codes). |
| `location.offices.city` | string\[] | Free text — any city name (e.g. `Berlin`) |
| Field | Type | Accepted Values |
| --------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `strategic_signal.partnership.name` | string\[] | Free text — any partner/company name (e.g. `sequoia`) |
| `strategic_signal.partnership.type` | string\[] | `channel_reseller_distributor`, `gtm_marketing`, `implementation_si_consulting`, `oem_whitelabel_licensing`, `strategic_codevelopment`, `technology_integration`, `others` |
| `strategic_signal.partnership.strategic_tier` | string\[] | Free text |
| Field | Type | Accepted Values |
| --------------------------------------- | --------- | ----------------------------------------------------------------- |
| `customer_profile.select_customer.name` | string\[] | Free text — any customer/company name (e.g. `Microsoft`, `Tesla`) |
| Field | Type | Accepted Values |
| ------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `industry.naics` | string\[] | NAICS industry codes. See the [NAICS Code List](/naics-codes). Matches a company carrying any of the selected codes. |
| `industry.sic` | string\[] | SIC industry codes. See the [SIC Code List](/sic-codes). Matches a company carrying any of the selected codes. |
| `industry.industry` | string\[] | akta.pro taxonomy industry codes. Use the [Industry Search API](/api-reference/supporting-apis/industry-search) to find matching codes. Matches any of the selected industries. |
| Field | Type | Accepted Values |
| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `technology.ai_maturity.scale` | number\[] | `0`, `1`, `2`, `3`, `4`, `5`
0 — No AI
1 — AI Assisted
2 — AI Featured
3 — AI Differentiated
4 — AI Native
5 — AI Foundational |
| `technology.api_detail.has_api` | boolean | `true`, `false` |
| `technology.app_detail.has_app` | boolean | `true`, `false` |
| `technology.is_technology_focussed` | boolean | `true`, `false` |
| Field | Type | Accepted Values |
| ---------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `funding_detail.funding_overview.funding_stage` | string\[] | `acquired`, `angel`, `corporate_funded`, `crowdfunded`, `debt_funded`, `initial_coin_offering`, `non_equity_assistance`, `post_ipo_debt`, `post_ipo_equity`, `pre_seed`, `private_equity`, `public`, `seed`, `series_a`, `series_b`, `series_c`, `series_d`, `series_e`, `series_f`, `series_g`, `series_h`, `series_i`, `series_j`, `venture_funded` |
| `funding_detail.funding_overview.total_funding_usd` | object | Range object. Accepts `gte` and/or `lte` (integer, USD). |
| `funding_detail.funding_overview.num_funding_rounds` | object | Range object. Accepts `gte` and/or `lte` (integer). |
| `funding_detail.funding_overview.last_funding_date` | object | Range object. Accepts `gte` and/or `lte` (date string, `YYYY-MM-DD`). |
| `funding_detail.funding_rounds` | object | Nested filter — conditions apply jointly to individual rounds, not the company's overall funding history. Sub-fields: `round` (string\[], same values as `funding_stage` above), `date` (object, `gte`/`lte` date string), `amount_usd` (object, `gte`/`lte` integer USD), `investors.uuid` (string\[], match rounds including any of the specified investor UUIDs), `investors.lead_investor` (boolean, match rounds where the specified investor(s) led). |
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:
```json theme={null}
{
"filters": {
"firmographic.company_type": ["private"],
"firmographic.founded_year": {"gte": 2015, "lte": 2022},
"location.hq.country": ["USA", "GBR"],
"financial_estimate.revenue_estimate": ["10m_25m", "25m_50m", "50m_100m"],
"technology.api_detail.has_api": true,
"business_model.gtm_motion": ["product_led_growth", "sales_led"],
"funding_detail.funding_rounds": {
"round": ["series_a", "series_b"],
"amount_usd": {"gte": 5000000}
}
}
}
```
Field to sort results by.
Available values: `relevance` (default), `revenue_estimate`, `valuation_estimate`, `employee_range`, `total_funding`, `founded_year`
Sort direction.
Available values: `asc`, `desc`
Default = `desc`
Maximum number of companies to return.
Default = 50
Max value = 500
Number of results to skip for pagination.
Default = 0
## Response
#### Successful Response Fields
List of matching company objects. Each object includes identity fields only: `uuid`, `name`, `website`, `product_category`, `company_type`.
Number of companies returned in this response.
Total number of companies matching your filters. Capped at 500.
Number of credits consumed by this request.
```json 200 expandable wrap theme={null}
{
"data": [
{
"uuid": "000002f",
"name": "MoonPay",
"website": "moonpay.com",
"product_category": "Crypto Payment Infrastructure",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "000007a",
"name": "Ondo Finance",
"website": "ondo.finance",
"product_category": "Tokenized Real-World Asset Platform",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00003eb",
"name": "Aptos",
"website": "aptoslabs.com",
"product_category": "Layer 1 Blockchain Infrastructure",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "0000jv6",
"name": "Algorand",
"website": "algorand.com",
"product_category": "Layer-1 Blockchain Infrastructure",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00004vi",
"name": "DoiT",
"website": "doit.com",
"product_category": "Cloud Cost Management & FinOps",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "0000ici",
"name": "CB Insights",
"website": "cbinsights.com",
"product_category": "Market Intelligence Platform",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00000uv",
"name": "Ava Labs",
"website": "avalabs.org",
"product_category": "Blockchain Infrastructure",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00004pq",
"name": "Backpack",
"website": "backpack.exchange",
"product_category": "Cryptocurrency Exchange",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00005gw",
"name": "Ataccama",
"website": "ataccama.com",
"product_category": "Data Quality and Governance Software",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "0000f42",
"name": "GoFundMe",
"website": "gofundme.com",
"product_category": "Crowdfunding Platform",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00000p2",
"name": "Jasper",
"website": "jasper.ai",
"product_category": "AI Marketing Software",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00002c8",
"name": "Safe Superintelligence",
"website": "ssi.inc",
"product_category": "AI Research & Development (Frontier AI Safety)",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00004la",
"name": "Pathlock",
"website": "pathlock.com",
"product_category": "Identity and Application Access Governance (ERP Security & GRC Software)",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "0000hp6",
"name": "Stacks",
"website": "stacks.co",
"product_category": "Bitcoin Layer-2 Blockchain Infrastructure",
"company_type": {
"code": "Public",
"label": "Public"
}
},
{
"uuid": "000apt4",
"name": "Campaign Monitor",
"website": "campaignmonitor.com",
"product_category": "Email Marketing Software",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00004gm",
"name": "CoinList",
"website": "coinlist.co",
"product_category": "Digital Asset Investment Platform",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "000bjpw",
"name": "Venice",
"website": "venice.ai",
"product_category": "Privacy-First AI Infrastructure Platform",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00003fu",
"name": "Lumeris",
"website": "lumeris.com",
"product_category": "Healthcare Value-Based Care Platform",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "00000kv",
"name": "Monad",
"website": "monad.xyz",
"product_category": "Layer 1 Blockchain Infrastructure",
"company_type": {
"code": "Private",
"label": "Private"
}
},
{
"uuid": "0000gz4",
"name": "DevRev",
"website": "devrev.ai",
"product_category": "AI Enterprise Software",
"company_type": {
"code": "Private",
"label": "Private"
}
}
],
"filters": {
"location.hq.country": [
"USA"
],
"business_model.offering_type": [
"software"
],
"funding_detail.funding_overview.funding_stage": [
"series_a"
]
},
"warnings": [],
"count": 20,
"total_count": 500,
"offset": 0,
"credits_consumed": 14
}
```
## OpenAPI
````yaml POST /v1/list/generate/companies
openapi: 3.0.3
info:
title: Akta.pro API
description: >
Akta provides APIs for company intelligence and news monitoring:
1. **News** – Enriched news articles with AI summaries, sentiment, event
tags, industry classifications, and company mention resolution.
2. **Company Enrichment** – Structured company data including firmographics,
funding, headcount, and financials.
3. **Company Search** – Free endpoint to resolve company names, domains, or
UUIDs.
4. **Product Reviews** – G2 product reviews with ratings and review content.
5. **Employee Reviews** – Employee sentiment data with workplace ratings.
**Authentication:** All endpoints require an API key in the `x-api-key` HTTP
header.
version: 1.0.0
contact:
url: https://akta.pro
servers:
- url: https://api.akta.pro/api
description: Production server
security: []
tags:
- name: News
description: Enriched news articles with AI summaries, sentiment, and company mentions
- name: Company
description: Company data enrichment, search, and addition
- name: Reviews
description: Product and employee reviews from external sources
- name: Supporting APIs
description: Utility endpoints for request tracking
- name: List Generation
description: >-
Build targeted company lists using structured filters or natural language
queries
externalDocs:
description: Official Akta.pro API Documentation
url: https://docs.akta.pro
paths:
/v1/list/generate/companies:
post:
tags:
- List Generation
description: >-
Build targeted company lists using structured filters, with optional
data enrichment.
operationId: generateCompanyList
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ListGenerationRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListGenerationResponse'
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- xApiKeyAuth: []
components:
schemas:
ListGenerationRequest:
required:
- filters
type: object
properties:
filters:
type: object
additionalProperties: true
description: >-
Structured filter conditions. Use the Filter Builder API to generate
valid filters. See filter options at /api-reference/listgen-api.
sections:
type: array
items:
type: string
description: >-
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:
type: string
enum:
- relevance
- revenue_estimate
- valuation_estimate
- employee_range
- total_funding
- founded_year
description: 'Field to sort results by. Default: relevance'
sort_order:
type: string
enum:
- asc
- desc
description: 'Sort direction. Default: desc'
limit:
type: integer
description: 'Maximum companies to return. Default: 50, Max: 500'
offset:
type: integer
description: 'Number of results to skip for pagination. Default: 0'
ListGenerationResponse:
type: object
properties:
data:
type: array
items:
type: object
description: >-
Company object with identity fields (uuid, name, website) plus any
requested enrichment sections.
count:
type: integer
description: Number of companies returned.
total_count:
type: integer
description: Total matching companies. Capped at 500.
credits_consumed:
type: number
format: float
description: Credits consumed. Returns 0 when no enrichment sections requested.
Error:
type: object
properties:
status:
type: string
message:
type: string
securitySchemes:
xApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key obtained from your Akta account.
````