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

> Make your first List Generation call and return a filtered list of matching companies.

## 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:** `https://api.akta.pro/api/v1/list/generate/companies/`

## 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/list/generate/companies/" \
    -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/list/generate/companies/"
  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": {
        "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
}
```

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. Refer to [API documentation](/api-reference/listgen-api) to know about adding filters.
