> ## 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. # Company Search > Resolve a company by name, website, or UUID and obtain the UUID used by other endpoints. ## Overview The Company Search API resolves a company name, website domain, or UUID into a structured company record. Its primary purpose is to look up the `uuid` needed by the other APIs when you only have a company name to start with. This is a **free endpoint** so it does not consume API credits. **Endpoint** ```text theme={null} GET https://api.akta.pro/api/v1/company/search ``` Pass a single `query` query parameter. The backend automatically detects whether the input is a company name, website domain or UUID and resolves it accordingly. *** ## Authentication All requests must include an **API key** in the `x-api-key` HTTP header. ```text theme={null} x-api-key: ``` Never expose your API key in client-side code, browser requests, or public repositories. A missing or invalid key returns `401 Unauthorized`. *** ## Request Reference | Parameter | Type | Required | Description | | --------- | ------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `query` | string | **Required** | Company name (e.g. `"Canva"`), website domain (e.g. `"canva.com"`), or UUID (e.g. `"00000l1"`). The API automatically identifies the input type and resolves it. | **Example requests:** ```bash cURL theme={null} curl --location 'https://api.akta.pro/api/v1/company/search?query=Canva' \ --header 'x-api-key: ' ``` ```python Python theme={null} import requests response = requests.get( "https://api.akta.pro/api/v1/company/search", headers={"x-api-key": ""}, params={"query": "Canva"} ) results = response.json()["data"] if results: company = results[0] print(f"UUID: {company['uuid']}") print(f"Name: {company['name']}") print(f"Website: {company['website']}") print(f"Status: {company['company_status']}") ``` *** ## Response ### Response envelope ```json expandable theme={null} { "data": [ { "uuid": "00000l1", "name": "Canva", "website": "canva.com", "product_category": "Visual Design Software", "company_status": "Private" }, { "uuid": "0000ee3", "name": "Canvas", "website": "canvasapp.com", "product_category": "Business Intelligence Software", "company_status": "Private" }, { "uuid": "0000f2d", "name": "Canvas", "website": "canvas.build", "product_category": "Construction Robotics", "company_status": "Private" }, { "uuid": "0000x73", "name": "Canvas", "website": "canvas.io", "product_category": "Spatial Intelligence and Reality Capture Software", "company_status": "Private" }, { "uuid": "0004l71", "name": "Canvas", "website": "gocanvas.io", "product_category": "Recruiting Software", "company_status": "Private" }, { "uuid": "0004rkg", "name": "Canvas", "website": "bycanvas.org", "product_category": "Arts and Cultural Philanthropy / Nonprofit Grantmaking", "company_status": "Private" }, { "uuid": "0006abd", "name": "Canvas", "website": "canvas-inc.com", "product_category": "Defense Engineering Services", "company_status": "Private" }, { "uuid": "0009xss", "name": "Canvas", "website": "canvasunited.com", "product_category": "Digital Marketing Services", "company_status": "Private" }, { "uuid": "000adw7", "name": "Canvas", "website": "drivecanvas.com", "product_category": "Vehicle Subscription Services", "company_status": null }, { "uuid": "000d9vu", "name": "Canvas", "website": "canvas-events.co.uk", "product_category": "Event Venue Marketplace", "company_status": "Private" }, { "uuid": "000gz8w", "name": "Canvas", "website": "canvasuae.com", "product_category": "Real Estate Brokerage", "company_status": "Private" }, { "uuid": "000ltt3", "name": "Canvas", "website": "canvas-research.com", "product_category": "Insufficient data", "company_status": "Private" }, { "uuid": "000m2w5", "name": "Canvas", "website": "canvaslaapts.com", "product_category": "Residential Apartment Rentals (Multifamily Housing)", "company_status": "Private" }, { "uuid": "000ps2l", "name": "Canvas", "website": "canvasrealestate.com", "product_category": "Commercial Real Estate Brokerage", "company_status": "Private" }, { "uuid": "000zly3", "name": "Canvas", "website": "canvascos.com", "product_category": "Real Estate Development", "company_status": "Private" }, { "uuid": "00269km", "name": "Canvas", "website": "canvas.krd", "product_category": "Digital Marketing Services", "company_status": "Private" }, { "uuid": "002romp", "name": "Canvas", "website": "canevas.be", "product_category": "Architecture and Engineering Services", "company_status": "Private" }, { "uuid": "002w1kw", "name": "Canvas", "website": "canvs.co.jp", "product_category": "Startup Studio / Venture Incubation Services", "company_status": "Private" }, { "uuid": "003764u", "name": "Canvas", "website": "leinwand-praesentationssoftware.de", "product_category": "Presentation and Drawing Software", "company_status": "Private" }, { "uuid": "0042w4m", "name": "Canvas", "website": "canvasliving.com.au", "product_category": "Build to Rent Property Management", "company_status": "Private" }, { "uuid": "0064st1", "name": "canvay", "website": "canvay.io", "product_category": "Web Hosting Services", "company_status": "Private" }, { "uuid": "00stcqh", "name": "Canvas", "website": "canvas-inc.co", "product_category": "Marketing Automation SaaS", "company_status": "Private" }, { "uuid": "0008n11", "name": "Canvas8", "website": "canvas8.com", "product_category": "Consumer Insights & Market Research", "company_status": "Private" }, { "uuid": "000c98x", "name": "Canvazo", "website": "canvazo.com", "product_category": "Art Supplies E-commerce", "company_status": "Private" }, { "uuid": "002l5yx", "name": "Canvass", "website": "canvass-srl.it", "product_category": "Industrial Cleaning Equipment & Supplies", "company_status": "Private" } ], "count": 25, "credits_consumed": 0 } ``` | Field | Type | Description | | ------------------ | --------- | ------------------------------------------------------------------------------ | | `data` | object\[] | Array of matching company objects. Empty array `[]` when no results are found. | | `credits_consumed` | float | Always `0.00` — this is a free endpoint. | ### Company object | Field | Type | Description | | ------------------ | ------------- | ----------------------------------------------------------------------------------------------------------------- | | `uuid` | string (UUID) | Unique akta.pro identifier for the company. Pass this as the `company` parameter in the Enrichment and News APIs. | | `name` | string | Legal or registered company name. | | `website` | string | Primary website URL, normalised with no trailing slash. | | `product_category` | string | Primary product or service category (e.g. `"SaaS"`, `"FinTech"`, `"Healthcare"`). | | `company_status` | string | Public market status: `"public"`, `"private"`, `"acquired"`, `"delisted"`, or `"unknown"`. | When no companies match the query, the API returns empty `data` array. *** ## Using the UUID in other APIs Once you have the `uuid`, pass it as the `company` field in downstream API calls: ```python theme={null} import requests HEADERS = {"x-api-key": "your-api-key"} # Step 1: Search for the company search = requests.get( "https://api.akta.pro/api/v1/company/search", headers=HEADERS, params={"query": "Canva"} ) uuid = search.json()["data"][0]["uuid"] # Step 2: Use the UUID in Company Data API enrich = requests.get( "https://api.akta.pro/api/v1/company/enrichment/", # was POST /v1/company/enrichment headers=HEADERS, params={"company": uuid, "sections": "firmographic,business_model"} ) enrich.raise_for_status() enrich_data = enrich.json() print(enrich_data["data"]["firmographic"]["name"]) # Or use it in the News API news = requests.get( "https://api.akta.pro/api/v1/news/", headers=HEADERS, params={"company": uuid, "limit": 10} ) news.raise_for_status() news_data = news.json() article_count = news_data.get("count", news_data.get("total", "unknown")) print(f"Found {article_count} articles") ```