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

Build a list by passing a `filters` object describing your target companies.

<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,
      "filters": {
        "location.hq.country": ["USA"],
        "business_model.offering_type": ["software"],
        "funding_detail.funding_overview.funding_stage": ["series_a"]
      }
    }'
  ```

  ```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,
    "filters": {
      "location.hq.country": ["USA"],
      "business_model.offering_type": ["software"],
      "funding_detail.funding_overview.funding_stage": ["series_a"]
    }
  }

  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"
      }
    }
  ],
  "filters": {
    "location.hq.country": [
      "USA"
    ],
    "business_model.offering_type": [
      "software"
    ],
    "funding_detail.funding_overview.funding_stage": [
      "series_a"
    ]
  },
  "warnings": [],
  "count": 10,
  "total_count": 500,
  "offset": 0,
  "credits_consumed": 14
}
```

<Info>
  Every company object always includes the same identity fields shown above — `uuid`, `name`, `website`, `product_category`, `company_type`. There is no option to enrich results with additional data sections; for deeper company data, look up the matching UUIDs with the [Company Data API](/docs/company-data/overview) or the [Company Enrichment Concise API](/docs/company-enrichment-concise/overview).
</Info>

## Adding more filters

Filters are grouped by data domain — firmographic, business model, financials, location, technology, funding, and more — and can be combined freely within a single request. Refer to the [API reference](/api-reference/listgen-api) for the full list of available filters.