> ## Documentation Index
> Fetch the complete documentation index at: https://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 or natural language query, with optional data enrichment.

## Overview

The List Generation API lets you build targeted company lists using two approaches:

1. **Structured Filters** - Applies specific criteria like company type, location, funding stage, or industry to filter companies
2. **Natural Language** - Describe what you're looking for in plain text and the API interprets your intent

Results are ranked by akta.pro relevance by default and can be enriched with additional company data sections.

<Note>
  The List Generation API is fully available on **Subscription** and **Enterprise** plans. On the **Pay-as-you-go** plan, list generation is limited to a maximum of 20 companies per request, and enrichment is not supported. See [Pricing](/getting-started/pricing) for plan details.
</Note>

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

<ParamField header="x-api-key" type="string" required>
  Your API key.
</ParamField>

#### Body Parameters

<ParamField body="query" type="string">
  Natural language search query. Use this when you want to describe your target companies in plain text (e.g., "SaaS companies in the US with Series A funding").

  Note: Cannot be used together with `filters`. Choose either `query` or `filters`, not both.
</ParamField>

<ParamField body="filters" type="object">
  Structured filter conditions. Use this when you need precise control over filtering criteria.

  Note: Cannot be used together with `query.`

  #### Available Filters

  <AccordionGroup>
    <Accordion title="Firmographic 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). <br />Eg. \{"gte": 2010, "lte": 2014 }                                                                                                                                 |
    </Accordion>

    <Accordion title="Business Model Filters">
      | 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` |
    </Accordion>

    <Accordion title="Company Assessment Filters">
      | 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` |
    </Accordion>

    <Accordion title="Financial Estimate Filters">
      | 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`                       |
    </Accordion>

    <Accordion title="Location Filters">
      | 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`)                                                             |
    </Accordion>

    <Accordion title="Strategic Signal Filters">
      | 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                                                                                                                                                                  |
    </Accordion>

    <Accordion title="Customer Profile Filters">
      | Field                                   | Type      | Accepted Values                                                   |
      | --------------------------------------- | --------- | ----------------------------------------------------------------- |
      | `customer_profile.select_customer.name` | string\[] | Free text — any customer/company name (e.g. `Microsoft`, `Tesla`) |
    </Accordion>

    <Accordion title="Industry Filters">
      | 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. |
    </Accordion>
  </AccordionGroup>

  <Accordion title="Technology Filters">
    | Field                               | Type      | Accepted Values                                                                                                                                                    |
    | ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | `technology.ai_maturity.scale`      | number\[] | `0`, `1`, `2`, `3`, `4`, `5`<br /><br />0 — No AI<br />1 — AI Assisted<br />2 — AI Featured<br />3 — AI Differentiated<br />4 — AI Native<br />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`                                                                                                                                                    |
  </Accordion>

  <AccordionGroup>
    <Accordion title="Funding Detail Filters">
      | 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). |
    </Accordion>
  </AccordionGroup>
</ParamField>

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}
    }
  }
}
```

<ParamField body="sections" type="string[]">
  Additional data sections to include for each company in the results.

  Available 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 only), `mna_and_investment` (Enterprise only)

  If omitted, results include only basic identity fields (uuid, name, website).<br /><br />Note: These sections are not supported on Pay-as-you-go plan.
</ParamField>

<ParamField body="sort_by" type="string">
  Field to sort results by.

  Available values: `relevance` (default), `revenue_estimate`, `valuation_estimate`, `employee_range`, `total_funding`, `founded_year`
</ParamField>

<ParamField body="sort_order" type="string">
  Sort direction.

  Available values: `asc`, `desc`

  Default = `desc`
</ParamField>

<ParamField body="limit" type="integer">
  Maximum number of companies to return.

  Default = 50

  Max value = 500<br /><br />Note: on Pay-as-you-go plan, maximum 20 companies are allowed.
</ParamField>

<ParamField body="offset" type="integer">
  Number of results to skip for pagination.

  Default = 0
</ParamField>

## Response

#### Successful Response Fields

<ResponseField name="data" type="array">
  List of matching company objects. Each object includes identity fields (uuid, name, website) plus any requested enrichment sections.
</ResponseField>

<ResponseField name="count" type="integer">
  Number of companies returned in this response.
</ResponseField>

<ResponseField name="total_count" type="integer">
  Total number of companies matching your filters. Capped at 500.
</ResponseField>

<ResponseField name="credits_consumed" type="float">
  Number of credits consumed by this request.
</ResponseField>

<ResponseExample>
  ```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"
        }
      },
      {
        "uuid": "0000c49",
        "name": "Place",
        "website": "place.com",
        "product_category": "Real Estate Technology",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0000qxo",
        "name": "Yield Guild Games",
        "website": "yieldguild.io",
        "product_category": "AI Data Services and Web3 Gaming",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00006vz",
        "name": "Fireflies.ai",
        "website": "fireflies.ai",
        "product_category": "AI Meeting Assistant Software",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "000079z",
        "name": "Figure Markets",
        "website": "figuremarkets.com",
        "product_category": "Blockchain-based Digital Asset Marketplace",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00000zg",
        "name": "Field AI",
        "website": "fieldai.com",
        "product_category": "Robot Autonomy Software",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0000091",
        "name": "Liquid AI",
        "website": "liquid.ai",
        "product_category": "AI Foundation Models",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00002qy",
        "name": "CallRail",
        "website": "callrail.com",
        "product_category": "Marketing Attribution and Call Analytics Software",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "003qcgm",
        "name": "Tempo",
        "website": "tempo.xyz",
        "product_category": "Blockchain Payment Infrastructure",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00006ra",
        "name": "iTrustCapital Inc.",
        "website": "itrustcapital.com",
        "product_category": "Digital Asset Retirement Platform",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00004wg",
        "name": "Rarible",
        "website": "rarible.com",
        "product_category": "NFT Marketplace",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0000931",
        "name": "OpenFX",
        "website": "openfx.com",
        "product_category": "Cross-Border Payment Infrastructure",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0002tai",
        "name": "Lightspark",
        "website": "lightspark.com",
        "product_category": "Bitcoin and Stablecoin Payments Infrastructure",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00026w2",
        "name": "The Graph",
        "website": "thegraph.com",
        "product_category": "Blockchain Data Infrastructure",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0002ozi",
        "name": "ActBlue",
        "website": "secure.actblue.com",
        "product_category": "Political Campaign Fundraising Software",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00004mw",
        "name": "Arkham Intelligence",
        "website": "arkhamintelligence.com",
        "product_category": "Blockchain Analytics and Crypto Intelligence",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00009ae",
        "name": "Blockworks",
        "website": "blockworks.com",
        "product_category": "Crypto Market Intelligence and On-Chain Data Analytics",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0000m5g",
        "name": "Sentora",
        "website": "sentora.com",
        "product_category": "Institutional DeFi Platform",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0000pnw",
        "name": "Wispr Flow",
        "website": "wisprflow.ai",
        "product_category": "AI Voice Dictation Software",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00000cx",
        "name": "Rezolve AI",
        "website": "rezolve.ai",
        "product_category": "Enterprise Agentic AI Software",
        "company_type": {
          "code": "Public",
          "label": "Public"
        }
      },
      {
        "uuid": "000036e",
        "name": "7AI",
        "website": "7AI.com",
        "product_category": "Cybersecurity Software / Security Operations (SOC) Platform",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00000kc",
        "name": "micro1",
        "website": "micro1.ai",
        "product_category": "AI Training Data & Evaluation Platform",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0000gat",
        "name": "R3",
        "website": "r3.com",
        "product_category": "Enterprise Blockchain Platform",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00003qa",
        "name": "Array",
        "website": "array.com",
        "product_category": "Embedded Fintech Platform",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "0003o96",
        "name": "Responsive",
        "website": "responsive.io",
        "product_category": "Strategic Response Management Software",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "000031g",
        "name": "Replika",
        "website": "replika.ai",
        "product_category": "AI Companion Apps",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00005i2",
        "name": "DNSFilter",
        "website": "dnsfilter.com",
        "product_category": "Network Security Software",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00008h9",
        "name": "GMI Cloud",
        "website": "gmicloud.ai",
        "product_category": "GPU Cloud Infrastructure",
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "00002jb",
        "name": "HeyGen",
        "website": "heygen.com",
        "product_category": null,
        "company_type": {
          "code": "Private",
          "label": "Private"
        }
      },
      {
        "uuid": "000pkt4",
        "name": "Unity",
        "website": "unity.com",
        "product_category": "Real-Time 3D Development Platform",
        "company_type": {
          "code": "Public",
          "label": "Public"
        }
      },
      {
        "uuid": "00006aa",
        "name": "Prime Intellect",
        "website": "primeintellect.ai",
        "product_category": "AI Training Infrastructure",
        "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": [],
    "skipped_sections": [],
    "count": 50,
    "total_count": 500,
    "offset": 0,
    "query_translated": true,
    "credits_consumed": 14
  }
  ```
</ResponseExample>


## 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 or natural
        language queries, 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:
      type: object
      properties:
        query:
          type: string
          description: >-
            Natural language search query (e.g. 'SaaS companies in the US with
            Series A funding'). Cannot be used with filters.
        filters:
          type: object
          additionalProperties: true
          description: >-
            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.
        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.

````