Quick Start

Authentication

All requests must include an API key in the x-api-key HTTP header.

x-api-key: <YOUR_API_KEY>

API keys are issued from your Akta account. Contact support@akta.pro if you do not yet have API access or need to rotate a key.

Never expose your API key in client-side code, browser requests, or public repositories. A missing or invalid key returns 401 Unauthorized.

Endpoint Details

Method: POST
Endpoint: /v1/company/list/generate

Execute your first request

The fastest way to get a list is a natural language query with no filters or enrichment:

curl --location 'https://api.akta.pro/v1/company/list/generate' \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "SaaS companies in the US with Series A funding",
    "limit": 10
  }'

import requests

response = requests.post(
    "https://api.akta.pro/v1/company/list/generate",
    headers={
        "x-api-key": "<YOUR_API_KEY>",
        "Content-Type": "application/json"
    },
    json={
        "query": "SaaS companies in the US with Series A funding",
        "limit": 10
    }
)
data = response.json()
print(f"Found {data['total_count']} companies, returning {data['count']}")

Sample response

{
  "data": [
    {
      "uuid": "00000l1",
      "name": "Canva",
      "website": "https://canva.com"
    },
    {
      "uuid": "00002m2",
      "name": "Figma",
      "website": "https://figma.com"
    }
  ],
  "count": 2,
  "total_count": 2,
  "credits_consumed": 0.0
}

Note that natural language queries with no sections requested return only identity fields (uuid, name, website) and consume 0 credits.

Adding structured filters instead of a query

If you know precisely which criteria define your target list, use filters instead of query. Filters are grouped by data domain — firmographic, business model, financials, location, technology, funding, and more. Every group below supports the same request/response shape; only the filter keys change.

Firmographic Filters

string[]

Filter by company ownership structure.Available values: private, public

string[]

Filter by how the company is owned or controlled.Available values: 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

string[]

Filter by the company’s current operating state.Available values: acquired, closed, ipo, operating

object

Filter by year the company was founded, using a range.Accepts gte and/or lte (integer, four-digit year).

Business Model Filters

string[]

Filter by go-to-market customer type.Available values: b2b, b2b_and_b2c, b2c

string[]

Filter by the primary type of offering.Available values: digital_commerce_content, hardware_manufacturing, services, software

string[]

Filter by the primary go-to-market motion used to acquire customers.Available values: 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

string[]

Filter by how the company primarily generates revenue.Available values: 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

Company Assessment Filters

string[]

Filter by how concentrated the company’s customer base is.Available values: critical, high, low, moderate

string[]

Filter by the type of competitive advantage the company holds.Available values: cost_advantage, data_advantage, distribution_advantage, ecosystem_lock_in, efficient_scale, intangible_assets, network_effects, regulatory_moat, switching_costs, talent_moat

Financial Estimate Filters

string[]

Filter by estimated annual revenue range.Available values: pre_revenue, under_1m, 1m_5m, 5m_10m, 10m_25m, 25m_50m, 50m_100m, 100m_250m, 250m_500m, 500m_1b, 1b_5b, over_5b

string[]

Filter by estimated company valuation range.Available values: under_10m, 10m_50m, 50m_100m, 100m_250m, 250m_500m, 500m_1b, 1b_5b, 5b_10b, 10b_25b, over_25b

Location Filters

string[]

Filter by the geographic region of the company’s headquarters.Available values: Africa, Asia, Europe, Latin America, Middle East, North America, Oceania

string[]

Filter by the country of the company’s headquarters, using 3-letter ISO country codes (e.g. USA, IND, GBR).Accepts any valid 3-letter ISO alpha-3 country code. Refer here.

string[]

Filter by the city of the company’s headquarters.Free text field — accepts any city name (e.g. delhi).

string[]

Filter by countries where the company actively serves customers, using 3-letter ISO country codes (e.g. USA, CHN).Accepts any valid 3-letter ISO alpha-3 country codes. Refer here.

boolean

Filter for companies that serve a global market.

string[]

Filter by countries where the company has office locations, using 3-letter ISO country codes (e.g. USA, DZA).Accepts any valid 3-letter ISO 3166-1 country code. Refer here.

Strategic Signal Filters

string[]

Filter by the name of a partner company.Free text field — accepts any partner/company name (e.g. sequoia).

string[]

Filter by the type of partnership.Available values: channel_reseller_distributor, gtm_marketing, implementation_si_consulting, oem_whitelabel_licensing, strategic_codevelopment, technology_integration, others

string

Filter by the strategic tier/importance of the partnership.Free text field.

Customer Profile Filters

string[]

Filter by the name of a known/select customer of the company.Free text field — accepts any customer/company name (e.g. Tata, Birla).

Industry Filters

string[]

Filter by NAICS industry codes. Matches a company carrying any of the selected codes.See the NAICS Code List for all available codes.

string[]

Filter by SIC industry codes. Matches a company carrying any of the selected codes.See the SIC Code List for all available codes.

string[]

Filter by akta.pro taxonomy industry codes. Matches any of the selected industries.Use the Industry Search API to find matching industry codes.

Technology Filters

string[]

Filter by the company’s AI maturity level. Matches any of the selected levels.Available values: ai_assisted, ai_featured, ai_differentiated, ai_native, ai_foundational

boolean

Filter for companies that offer a public API.

boolean

Filter for companies that offer a mobile application.

boolean

Filter for companies that are primarily technology-focused.

Funding Detail Filters (Enterprise only)

string[]

Filter by the company’s most recent/current funding stage.Available values: 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

object

Filter by total funding raised to date, in USD, using a range.Accepts gte and/or lte (integer).

object

Filter by the total number of funding rounds raised, using a range.Accepts gte and/or lte (integer).

object

Filter by the date of the company’s most recent funding round, using a range.Accepts gte and/or lte (date string, YYYY-MM-DD).

object

Filter for companies with a specific funding round matching all specified sub-criteria. This is a nested filter — conditions apply jointly to individual rounds, not the company’s overall funding history.Supports the following sub-fields:

round (string[]) — funding round type. Same available values as funding_detail.funding_overview.funding_stage above.
date (object) — round date range. Accepts gte/lte (date string, YYYY-MM-DD).
amount_usd (object) — round amount range, in USD. Accepts gte/lte (integer).
investors.uuid (string[]) — match rounds that include any of the specified investor UUIDs.
investors.lead_investor (boolean) — match rounds where the specified investor(s) led the round.

Example filters request

curl --location 'https://api.akta.pro/v1/company/list/generate' \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "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"]
    },
    "sections": ["firmographic", "location", "financial_estimate"],
    "sort_by": "revenue_estimate",
    "sort_order": "desc",
    "limit": 50
  }'

import requests

response = requests.post(
    "https://api.akta.pro/v1/company/list/generate",
    headers={
        "x-api-key": "<YOUR_API_KEY>",
        "Content-Type": "application/json"
    },
    json={
        "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"]
        },
        "sections": ["firmographic", "location", "financial_estimate"],
        "sort_by": "revenue_estimate",
        "sort_order": "desc",
        "limit": 50
    }
)
data = response.json()
for company in data["data"]:
    print(company["name"], company.get("financial_estimate", {}))

Sample response

200

{
  "data": [
    {
      "uuid": "000031n-tesla",
      "name": "Tesla",
      "website": "https://tesla.com",
      "firmographic": {
        "company_type": "Public",
        "founded_year": 2003,
        "headcount_range": "10001+"
      },
      "financial_estimate": {
        "revenue_estimate": "over_5b",
        "valuation_estimate": "over_25b"
      }
    }
  ],
  "count": 1,
  "total_count": 1,
  "credits_consumed": 2.0
}

Enrichment sections

Pass sections to include additional data blocks for each matching company. If omitted, results include only basic identity fields (uuid, name, website).

string[]

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)

Sorting and pagination

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, desc. Default = desc

integer

Maximum number of companies to return. Default = 50. Max value = 500.

integer

Number of results to skip for pagination. Default = 0.

Getting Started

API Products

Resources

Developer Tools

Authentication

Endpoint Details

Execute your first request

Adding structured filters instead of a query

Example filters request

Enrichment sections

​Authentication

​Endpoint Details

​Execute your first request

​Adding structured filters instead of a query

​Example filters request

​Enrichment sections

​Sorting and pagination

Authentication

Endpoint Details

Execute your first request

Adding structured filters instead of a query

Example filters request

Enrichment sections

Sorting and pagination