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

> Returns the curated peer set for a company in a single call.

## Overview

The Company Peers API returns the curated peer set for a single company. Pass the company website or UUID in the path and get back an array of peers — each tagged with a relationship type (`direct_peer`, `broad_incumbent`, or `emerging_player`) and a description of why it competes with the requested company.

## Endpoint Details

* **Method:** GET
* **Endpoint:** `/api/v1/company/enrichment/peers/{company}/`

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

## Path Parameters

<ParamField path="company" type="string" required>
  Company website (e.g. `canva.com`) or a company UUID (e.g. `00031n-tesla`). The UUID can be obtained from the Company Search API.
</ParamField>

#### Example Request

```text theme={null}
GET /v1/company/enrichment/peers/canva.com
x-api-key: <your_api_key>
```

## Response

#### Successful Response Fields

Returns a JSON object with the following structure:

<ResponseField name="credits_consumed" type="float">
  Number of credits consumed. Flat cost per call.
</ResponseField>

<ResponseField name="data" type="object">
  Peer list payload for the requested company.

  <Expandable title="properties">
    <ResponseField name="uuid" type="string">
      Akta UUID of the requested company.
    </ResponseField>

    <ResponseField name="peers" type="array">
      Array of peer companies.

      <Expandable title="item properties">
        <ResponseField name="name" type="string">
          Display name of the peer company.
        </ResponseField>

        <ResponseField name="uuid" type="string">
          Akta UUID of the peer. Pass it to the Company Data API to enrich the peer further.
        </ResponseField>

        <ResponseField name="type" type="object">
          Relationship bucket.

          <Expandable title="properties">
            <ResponseField name="code" type="string">
              One of `direct_peer`, `broad_incumbent`, `emerging_player`.
            </ResponseField>

            <ResponseField name="label" type="string">
              Human-readable label.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="description" type="string">
          One-paragraph explanation of the competitive angle.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml GET /v1/company/enrichment/peers/{company}
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, search, and addition
  - name: Reviews
    description: Product and employee reviews from external sources
  - name: Supporting APIs
    description: Utility endpoints for request tracking
  - name: List Generation
    description: >-
      Build targeted company lists using structured filters or natural language
      queries
externalDocs:
  description: Official Akta.pro API Documentation
  url: https://docs.akta.pro
paths:
  /v1/company/enrichment/peers/{company}:
    get:
      tags:
        - Company
      summary: Company Peers
      description: Returns the curated peer set for a company in a single call.
      operationId: companyEnrichmentPeers
      parameters:
        - name: company
          in: path
          required: true
          schema:
            type: string
          description: >-
            Company website (e.g. 'canva.com') or a company UUID (e.g.
            '00031n-tesla'). The UUID can be obtained from the Company Search
            API.
      responses:
        '200':
          description: Peer list returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      uuid:
                        type: string
                        description: Akta UUID of the requested company.
                      peers:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                            uuid:
                              type: string
                              description: >-
                                Akta UUID of the peer. Pass to the Company Data
                                API to enrich.
                            type:
                              type: object
                              properties:
                                code:
                                  type: string
                                  description: >-
                                    One of direct_peer, broad_incumbent,
                                    emerging_player.
                                label:
                                  type: string
                            description:
                              type: string
                  credits_consumed:
                    type: number
                    format: float
                    description: Number of credits consumed (0.5).
        '401':
          description: Unauthorized — missing or invalid API key.
      security:
        - xApiKeyAuth: []
components:
  securitySchemes:
    xApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key obtained from your Akta account.

````