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

# Quick Start

## Authentication

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

```text theme={null}
x-api-key: <YOUR_API_KEY>
```

API keys are issued from your akta.pro account. Contact [support@akta.pro](mailto:support@akta.pro) if you do not yet have API access or need to rotate a key.

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

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

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.akta.pro/api/v1/company/list/generate/" \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"limit":50,"query":"SaaS companies in the US with Series A funding"}'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.akta.pro/api/v1/company/list/generate/"
  headers = {"x-api-key": "YOUR_API_KEY"}
  payload = {
    "limit": 50,
    "query": "SaaS companies in the US with Series A funding"
  }

  response = requests.post(url, headers=headers, json=payload)
  data = response.json()

  print(data["count"], "companies")
  ```
</CodeGroup>

**Sample response**

```json expandable theme={null}
{
  "data": [
    {
      "uuid": "000002f",
      "name": "MoonPay",
      "website": "moonpay.com",
      "product_category": "Crypto Payment Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "000002f",
      "name": "MoonPay",
      "website": "moonpay.com",
      "product_category": "Crypto Payment Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "000007a",
      "name": "Ondo Finance",
      "website": "ondo.finance",
      "product_category": "Tokenized Real-World Asset Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "000007a",
      "name": "Ondo Finance",
      "website": "ondo.finance",
      "product_category": "Tokenized Real-World Asset Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00003eb",
      "name": "Aptos",
      "website": "aptoslabs.com",
      "product_category": "Layer 1 Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000jv6",
      "name": "Algorand",
      "website": "algorand.com",
      "product_category": "Layer-1 Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000jv6",
      "name": "Algorand",
      "website": "algorand.com",
      "product_category": "Layer-1 Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00004vi",
      "name": "DoiT",
      "website": "doit.com",
      "product_category": "Cloud Cost Management & FinOps",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00003eb",
      "name": "Aptos",
      "website": "aptoslabs.com",
      "product_category": "Layer 1 Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00004vi",
      "name": "DoiT",
      "website": "doit.com",
      "product_category": "Cloud Cost Management & FinOps",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000ici",
      "name": "CB Insights",
      "website": "cbinsights.com",
      "product_category": "Market Intelligence Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000uv",
      "name": "Ava Labs",
      "website": "avalabs.org",
      "product_category": "Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00004pq",
      "name": "Backpack",
      "website": "backpack.exchange",
      "product_category": "Cryptocurrency Exchange",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000ici",
      "name": "CB Insights",
      "website": "cbinsights.com",
      "product_category": "Market Intelligence Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00005gw",
      "name": "Ataccama",
      "website": "ataccama.com",
      "product_category": "Data Quality and Governance Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00005gw",
      "name": "Ataccama",
      "website": "ataccama.com",
      "product_category": "Data Quality and Governance Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000f42",
      "name": "GoFundMe",
      "website": "gofundme.com",
      "product_category": "Crowdfunding Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00004pq",
      "name": "Backpack",
      "website": "backpack.exchange",
      "product_category": "Cryptocurrency Exchange",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000p2",
      "name": "Jasper",
      "website": "jasper.ai",
      "product_category": "AI Marketing Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000p2",
      "name": "Jasper",
      "website": "jasper.ai",
      "product_category": "AI Marketing Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00002c8",
      "name": "Safe Superintelligence",
      "website": "ssi.inc",
      "product_category": "AI Research & Development (Frontier AI Safety)",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00002c8",
      "name": "Safe Superintelligence",
      "website": "ssi.inc",
      "product_category": "AI Research & Development (Frontier AI Safety)",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00004la",
      "name": "Pathlock",
      "website": "pathlock.com",
      "product_category": "Identity and Application Access Governance (ERP Security & GRC Software)",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00004la",
      "name": "Pathlock",
      "website": "pathlock.com",
      "product_category": "Identity and Application Access Governance (ERP Security & GRC Software)",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000f42",
      "name": "GoFundMe",
      "website": "gofundme.com",
      "product_category": "Crowdfunding Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000uv",
      "name": "Ava Labs",
      "website": "avalabs.org",
      "product_category": "Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000hp6",
      "name": "Stacks",
      "website": "stacks.co",
      "product_category": "Bitcoin Layer-2 Blockchain Infrastructure",
      "company_type": "Public",
      "hq_country": "USA"
    },
    {
      "uuid": "0000hp6",
      "name": "Stacks",
      "website": "stacks.co",
      "product_category": "Bitcoin Layer-2 Blockchain Infrastructure",
      "company_type": "Public",
      "hq_country": "USA"
    },
    {
      "uuid": "000apt4",
      "name": "Campaign Monitor",
      "website": "campaignmonitor.com",
      "product_category": "Email Marketing Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00004gm",
      "name": "CoinList",
      "website": "coinlist.co",
      "product_category": "Digital Asset Investment Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "000bjpw",
      "name": "Venice",
      "website": "venice.ai",
      "product_category": "Privacy-First AI Infrastructure Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "000bjpw",
      "name": "Venice",
      "website": "venice.ai",
      "product_category": "Privacy-First AI Infrastructure Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00003fu",
      "name": "Lumeris",
      "website": "lumeris.com",
      "product_category": "Healthcare Value-Based Care Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00003fu",
      "name": "Lumeris",
      "website": "lumeris.com",
      "product_category": "Healthcare Value-Based Care Platform",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000gz4",
      "name": "DevRev",
      "website": "devrev.ai",
      "product_category": "AI Enterprise Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000kv",
      "name": "Monad",
      "website": "monad.xyz",
      "product_category": "Layer 1 Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000kv",
      "name": "Monad",
      "website": "monad.xyz",
      "product_category": "Layer 1 Blockchain Infrastructure",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "000apt4",
      "name": "Campaign Monitor",
      "website": "campaignmonitor.com",
      "product_category": "Email Marketing Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000gz4",
      "name": "DevRev",
      "website": "devrev.ai",
      "product_category": "AI Enterprise Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000qxo",
      "name": "Yield Guild Games",
      "website": "yieldguild.io",
      "product_category": "AI Data Services and Web3 Gaming",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000c49",
      "name": "Place",
      "website": "place.com",
      "product_category": "Real Estate Technology",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000c49",
      "name": "Place",
      "website": "place.com",
      "product_category": "Real Estate Technology",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000qxo",
      "name": "Yield Guild Games",
      "website": "yieldguild.io",
      "product_category": "AI Data Services and Web3 Gaming",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00006vz",
      "name": "Fireflies.ai",
      "website": "fireflies.ai",
      "product_category": "AI Meeting Assistant Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00006vz",
      "name": "Fireflies.ai",
      "website": "fireflies.ai",
      "product_category": "AI Meeting Assistant Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "000079z",
      "name": "Figure Markets",
      "website": "figuremarkets.com",
      "product_category": "Blockchain-based Digital Asset Marketplace",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000zg",
      "name": "Field AI",
      "website": "fieldai.com",
      "product_category": "Robot Autonomy Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00000zg",
      "name": "Field AI",
      "website": "fieldai.com",
      "product_category": "Robot Autonomy Software",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "0000091",
      "name": "Liquid AI",
      "website": "liquid.ai",
      "product_category": "AI Foundation Models",
      "company_type": "Private",
      "hq_country": "USA"
    },
    {
      "uuid": "00002qy",
      "name": "CallRail",
      "website": "callrail.com",
      "product_category": "Marketing Attribution and Call Analytics Software",
      "company_type": "Private",
      "hq_country": "USA"
    }
  ],
  "filters": [
    {
      "field": "location.hq.country",
      "operator": "in",
      "value": [
        "USA"
      ]
    },
    {
      "field": "business_model.offering_type",
      "operator": "in",
      "value": [
        "software"
      ]
    },
    {
      "field": "funding_detail.funding_overview.funding_stage",
      "operator": "in",
      "value": [
        "series_a"
      ]
    }
  ],
  "warnings": [],
  "skipped_sections": [],
  "count": 50,
  "total_count": 500,
  "query_translated": true,
  "credits_consumed": 14
}
```

Note that a request with no `sections` requested return only identity fields such as`uuid`, `name`, `website` .

## 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. Refer to [API reference](/api-reference/listgen-api) to know more about how to pass filters in the request.
