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

# Company Search API

> Resolves a company by name, website or UUID and returns core identity and classification fields.

## Overview

The Company Search API resolves a company from a single input. It could be a name, website or UUID and returns core identity and classification fields. The backend automatically detects the input type, so callers don't need to specify whether they're passing a name, domain or identifier. This is a free endpoint and does not consume credits. Results are returned in the API response.

## Endpoint Details

* **Method:** GET
* **Endpoint:** `/v1/company/search`

## Authentication requirements

* Include a valid API key in the `x-api-key` request header.

## Request

### Request Parameters

#### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key.
</ParamField>

## URL Parameters

<ParamField query="query" type="string" required>
  A company name, website. The backend automatically resolves the input type. Examples: `https://canva.com`, `canva`
</ParamField>

## Response

#### Successful Response Fields

Returns a JSON object with the following structure:

<ResponseField name="data" type="array">
  List of matching company objects. Returns an empty array when no matches are found. See **Company Object Fields** below.
</ResponseField>

<ResponseField name="credits_consumed" type="float">
  Credits consumed by the request. This endpoint is free and always returns `0.00`.
</ResponseField>

#### Company Object Fields

<ResponseField name="uuid" type="string">
  Unique identifier for the company in UUID format.
</ResponseField>

<ResponseField name="name" type="string">
  Legal or registered name of the company.
</ResponseField>

<ResponseField name="website" type="string">
  Primary website URL. Normalized with no trailing slash.
</ResponseField>

<ResponseField name="product_category" type="string">
  Primary product or service category. Example: `SaaS`, `FinTech`, `Healthcare`.
</ResponseField>

<ResponseField name="company_status" type="string">
  Public market status. Allowed values: `public`, `private`, `acquired`, `delisted`, `unknown`.
</ResponseField>

<ResponseExample>
  ```json 200 expandable wrap theme={null}
  {
      "data": [
          {
              "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
              "name": "Acme Corporation",
              "website": "https://acme.com",
              "product_category": "SaaS",
              "company_status": "public"
          }
      ],
      "credits_consumed": 0.00
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v1/company/search
openapi: 3.0.3
info:
  title: Akta.pro API
  description: >
    Akta provides APIs for company intelligence and news monitoring:


    1. **News** – Enriched news articles with AI summaries, sentiment, event
    tags, industry classifications, and company mention resolution.

    2. **Company Enrichment** – Structured company data including firmographics,
    funding, headcount, and financials.

    3. **Company Search** – Free endpoint to resolve company names, domains, or
    UUIDs.

    4. **Product Reviews** – G2 product reviews with ratings and review content.

    5. **Employee Reviews** – Employee sentiment data with workplace ratings.


    **Authentication:** All endpoints require an API key in the `x-api-key` HTTP
    header.
  version: 1.0.0
  contact:
    url: https://akta.pro
servers:
  - url: https://api.akta.pro/api
    description: Production server
security: []
tags:
  - name: News
    description: Enriched news articles with AI summaries, sentiment, and company mentions
  - name: Company
    description: Company data enrichment and search
  - name: Reviews
    description: Product and employee reviews from external sources
externalDocs:
  description: Official Akta.pro API Documentation
  url: https://docs.akta.pro
paths:
  /v1/company/search:
    get:
      tags:
        - Company
      summary: Company Search
      description: >
        Resolve a company name, website domain, or UUID into a structured
        company record.

        This is a free endpoint — it does not consume API credits.
      operationId: companySearch
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
          description: >-
            A company name, website. The backend automatically resolves the
            input type. Examples: https://canva.com, canva
      responses:
        '200':
          description: Search results returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CompanySearchResult'
                  credits_consumed:
                    type: number
                    format: float
                    example: 0
        '204':
          description: No content — no companies matched the query.
        '400':
          description: Bad request — missing or malformed query parameter.
        '401':
          description: Unauthorized — missing or invalid API key.
      security:
        - xApiKeyAuth: []
components:
  schemas:
    CompanySearchResult:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
          description: Unique Akta identifier for the company.
        name:
          type: string
          description: Legal or registered company name.
        website:
          type: string
          format: uri
          description: Primary website URL.
        product_category:
          type: string
          description: Primary product or service category.
        company_status:
          type: string
          enum:
            - public
            - private
            - acquired
            - delisted
            - unknown
          description: Public market status.
  securitySchemes:
    xApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key obtained from your Akta account.

````