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

# Best Practices

**Always specify** `sections `**. Never rely on the default**

When `sections` is omitted, all available sections are returned. This would consume credits. Always be explicit:

```python theme={null}
# ❌ Returns everything — slow and large
params={"company": "canva.com"}

# ✅ Returns only what you need
params={"company": "canva.com", "sections": "firmographics,funding"}
```

**Accept both domain and full URL formats**

The `company` parameter accepts both bare domains (`canva.com`) and full URLs (`https://www.canva.com`). Either format works so use whichever is more natural for your pipeline. If you have a UUID from Company Search, prefer that for the most reliable resolution:

```python theme={null}
# All three are valid
params={"company": "canva.com"}
params={"company": "https://www.canva.com"}
params={"company": "00000l1"}
```

**Use Company Search to resolve names to UUIDs before enriching**

If your input is a company name (not a domain), resolve it to a UUID via the Company Search API first. Passing a display name like `"Canva"` directly as the `company` parameter may not resolve. Use the domain or UUID returned by Company Search:

```python theme={null}
import requests

API_KEY = "YOUR API KEY"
HEADERS = {"x-api-key": API_KEY}

def get_company_uuid(company_name):
    search = requests.get(
        "https://api.akta.pro/api/v1/company/search",
        headers=HEADERS,
        params={"query": company_name}
    )
    search.raise_for_status()

    results = search.json().get("data", [])
    if not results:
        raise ValueError(f"Company not found: {company_name}")

    return results[0]["uuid"]

if __name__ == "__main__":
    company_uuid = get_company_uuid("Canva")
    print(f"UUID: {company_uuid}")
```

**Sections for Enterprise tier** - `funding_detail `**and** `mna_and_investment`**require enterprise tier**

The `funding_detail`  and `mna_and_investment` sections are gated to enterprise plans. If your plan does not include them, requesting them returns a `403 Forbidden`. Handle this in your section selection logic rather than letting it surface as an uncaught error.