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

# Use cases

### Deal screening: firmographics and GTM details for a target

<CodeGroup>
  ```bash cURL theme={null}
  curl --location 'https://api.akta.pro/api/v1/company/enrichment?company=htpps%3A%2F%2Fulteig.com&sections=firmographics%2C%20gtm_and_business_model' \
  --header 'x-api-key: YOUR API KEY' \
  --data ''
  ```

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

  url = "https://api.akta.pro/api/v1/company/enrichment?company=htpps://ulteig.com&sections=firmographics, gtm_and_business_model"

  payload = ""
  headers = {
    'x-api-key': 'your api key'
  }

  response = requests.request("GET", url, headers=headers, data=payload)

  print(response.text)
  ```
</CodeGroup>

**Sample response:**

```json expandable theme={null}
{
    "data": {
        "uuid": "00081ss-ulteig",
        "firmographics": {
            "name": "Ulteig",
            "website": "http://ulteig.com",
            "location": "Austin, United States",
            "founded_year": 1944,
            "type": "private",
            "operating_status": "Operating",
            "ticker": "",
            "region": "North America",
            "country_code": "United States",
            "product_category": "Civil Engineering Infrastructure Services",
            "core_offering": "Ulteig is a civil engineering company that provides comprehensive engineering design, program management, and field services across various sectors including power, renewable energy, transportation, and water management.",
            "product_catalog": [
                "engineering design services",
                "program management",
                "environmental planning and services",
                "construction management",
                "land surveying"
            ]
        },
        "gtm_and_business_model": {
            "business_model_classification": "B2B",
            "technology_classification": "NO",
            "marketplace_classification": "NO",
            "offering_type": "Services",
            "customer_segments": [
                "municipalities",
                "power generation companies",
                "renewable energy firms",
                "transportation agencies",
                "water management authorities"
            ],
            "revenue_streams": [
                "Service fees"
            ],
            "pricing_strategy": [
                "Fixed fee for services",
                "Variable pricing based on project scale"
            ],
            "cost_structure": [
                "Personnel",
                "Operations",
                "Technology or R&D",
                "Marketing or Sales"
            ],
            "value_proposition": "Ulteig leverages over 75 years of experience to deliver reliable and innovative infrastructure solutions, ensuring client success and project integrity.",
            "technology": [
                "3D modeling capabilities",
                "GIS technology integration"
            ],
            "distribution": [
                "Direct sales to clients in various sectors",
                "Project-based engagements with municipalities and corporations",
                "Strong presence in North American markets"
            ]
        }
    },
    "credits_consumed": 1.5
}
```

### CRM enrichment helper

Resolve a company name via Company Search, then enrich synchronously for a CRM record update.

```python theme={null}
import requests

HEADERS = {"x-api-key": "<YOUR_API_KEY>"}

def enrich_by_name(company_name, sections):
    # Step 1: resolve to UUID via Company Search
    search = requests.get(
        "https://api.akta.pro/api/v1/company/search",
        headers=HEADERS,
        params={"name": company_name}
    )
    results = search.json().get("data", [])
    if not results:
        raise ValueError(f"Company not found: {company_name}")

    company_uuid = results[0]["uuid"]

    # Step 2: enrich using the UUID
    enrich = requests.get(
        "https://api.akta.pro/api/v1/company/enrichment",
        headers=HEADERS,
        params={"company": company_uuid, "sections": ",".join(sections)}
    )
    return enrich.json()["data"]

data = enrich_by_name("Stripe", ["firmographics", "funding"])
overall = data["funding"]["overall"]
print(f"{data['firmographics']['name']}: ${overall['total_funding'] / 1e9:.1f}B raised ({overall['funding_stage']})")
```

### Batch enrichment across a watchlist

Enrich multiple companies concurrently by running parallel requests.

```python theme={null}
import requests, concurrent.futures

HEADERS = {"x-api-key": "<YOUR_API_KEY>"}

WATCHLIST = ["stripe.com", "figma.com", "notion.so", "loom.com", "miro.com"]
SECTIONS  = "firmographics,funding,headcount"

def enrich_company(domain):
    r = requests.get(
        "https://api.akta.pro/api/v1/company/enrichment",
        headers=HEADERS,
        params={"company": domain, "sections": SECTIONS}
    )
    return domain, r.json().get("data", {})

with concurrent.futures.ThreadPoolExecutor(max_workers=5) as pool:
    results = dict(pool.map(lambda d: enrich_company(d), WATCHLIST))

print(f"{'Company':<20} {'Status':<12} {'Stage':<22} {'Total Raised'}")
print("-" * 72)
for domain, data in results.items():
    firm    = data.get("firmographics", {})
    funding = data.get("funding", {}).get("overall", {})
    total   = funding.get("total_funding", 0)
    total_s = f"${total / 1e9:.1f}B" if total >= 1e9 else (f"${total / 1e6:.0f}M" if total > 0 else "—")
    print(
        f"{firm.get('name', domain):<20} "
        f"{firm.get('company_status', '—'):<12} "
        f"{funding.get('funding_stage', '—'):<22} "
        f"{total_s}"
    )
```