> ## Documentation Index
> Fetch the complete documentation index at: https://testdocs.clodura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrich Company Profiles with Firmographic and Tech Data

> Retrieve deep company profiles including firmographics, technographics, funding history, and acquisition details using an organisation ID or LinkedIn URL.

The Enrich Company endpoint retrieves a comprehensive profile for any organization in Clodura's database. At its core, every request returns firmographic data — company name, domain, founding year, industry, employee count, revenue, HQ address, contact details, and key financial metrics. You can optionally expand the response with three additional data components: technographics (tech stack, programming languages, operating systems), acquisition history, and funding event details. Each additional component adds one credit to the base cost.

You must supply at least one unique identifier — either an `organisationId` (obtained from [Search Organizations](/api/company/search-organizations)) or an `orgLinkedinUrl`. If both are provided, `organisationId` takes precedence.

<Note>
  **Credit cost by requested components:**

  | Components Requested                    | Credits   |
  | --------------------------------------- | --------- |
  | Base firmographics only                 | 1 credit  |
  | Base + Technographics                   | 2 credits |
  | Base + Acquisitions                     | 2 credits |
  | Base + Funding Details                  | 2 credits |
  | Base + Technographics + Acquisitions    | 3 credits |
  | Base + Technographics + Funding Details | 3 credits |
  | Base + Acquisitions + Funding Details   | 3 credits |
  | All components (max)                    | 4 credits |
</Note>

## Endpoint

`POST /api/v1/organisation/enrich`

## Request

### Headers

| Header         | Value                |
| -------------- | -------------------- |
| `X-API-KEY`    | Your Clodura API key |
| `Content-Type` | `application/json`   |

### Body Parameters

<ParamField body="organisationId" type="string">
  Clodura's unique identifier for the company. Obtain this from the [Search Organizations](/api/company/search-organizations) endpoint. Provide either this field or `orgLinkedinUrl`.
</ParamField>

<ParamField body="orgLinkedinUrl" type="string">
  Full LinkedIn Company profile URL (e.g., `https://www.linkedin.com/company/clodura-ai/`). Required if `organisationId` is not provided.
</ParamField>

<ParamField body="includeTechnographics" type="boolean">
  When `true`, the response includes the company's technology stack, programming languages, operating systems, and products in use. Adds 1 credit. Defaults to `false`.
</ParamField>

<ParamField body="includeAcquisitions" type="boolean">
  When `true`, the response includes a list of companies acquired by the organization and any subsidiary relationships. Adds 1 credit. Defaults to `false`.
</ParamField>

<ParamField body="includeFunding" type="boolean">
  When `true`, the response includes all recorded funding events with round type, investors, date, and amount. Adds 1 credit. Defaults to `false`.
</ParamField>

<Warning>
  You must provide at least one of `organisationId` or `orgLinkedinUrl`. Requests that include neither will be rejected with a `422` error.
</Warning>

## Example Request

<CodeGroup>
  ```bash cURL — Base Enrichment theme={null}
  curl --request POST \
    --url https://api.clodura.ai/api/v1/organisation/enrich \
    --header 'X-API-KEY: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "organisationId": "2389402640191586304"
    }'
  ```

  ```bash cURL — Full Enrichment (all components) theme={null}
  curl --request POST \
    --url https://api.clodura.ai/api/v1/organisation/enrich \
    --header 'X-API-KEY: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "orgLinkedinUrl": "https://www.linkedin.com/company/circuitry-ai/",
      "includeTechnographics": true,
      "includeAcquisitions": true,
      "includeFunding": true
    }'
  ```

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

  url = "https://api.clodura.ai/api/v1/organisation/enrich"

  headers = {
      "X-API-KEY": "YOUR_API_KEY",
      "Content-Type": "application/json"
  }

  # Base enrichment by organisation ID (1 credit)
  payload = {
      "organisationId": "2389402640191586304"
  }

  # Full enrichment by LinkedIn URL (4 credits)
  # payload = {
  #     "orgLinkedinUrl": "https://www.linkedin.com/company/circuitry-ai/",
  #     "includeTechnographics": True,
  #     "includeAcquisitions": True,
  #     "includeFunding": True
  # }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())
  ```
</CodeGroup>

## Response

A successful `200` response returns an `organisation` object containing all requested data components.

<ResponseField name="organisation" type="object">
  <Expandable title="Core firmographic fields (always returned)">
    <ResponseField name="id" type="string">
      Clodura's unique identifier for this organization.
    </ResponseField>

    <ResponseField name="name" type="string">
      The company's name.
    </ResponseField>

    <ResponseField name="websiteUrl" type="string">
      The company's primary website URL.
    </ResponseField>

    <ResponseField name="linkedinUrl" type="string">
      The company's LinkedIn page URL.
    </ResponseField>

    <ResponseField name="primaryDomain" type="string">
      The company's primary web domain.
    </ResponseField>

    <ResponseField name="description" type="string">
      A description of the company's business.
    </ResponseField>

    <ResponseField name="foundedYear" type="string">
      Year the company was founded.
    </ResponseField>

    <ResponseField name="industry" type="array">
      Industry sectors the company operates in.
    </ResponseField>

    <ResponseField name="estimatedNumEmployees" type="string">
      Estimated headcount range (e.g., `51-200`).
    </ResponseField>

    <ResponseField name="companyPhoneNumbers" type="array">
      Company switchboard or main phone numbers.
    </ResponseField>

    <ResponseField name="companyEmails" type="array">
      General contact email addresses for the company.
    </ResponseField>

    <ResponseField name="hqRawAddress" type="string">
      Full headquarters street address.
    </ResponseField>

    <ResponseField name="hqCity" type="string">
      City of headquarters.
    </ResponseField>

    <ResponseField name="hqState" type="string">
      State of headquarters.
    </ResponseField>

    <ResponseField name="hqPostalCode" type="string">
      Postal code of headquarters.
    </ResponseField>

    <ResponseField name="hqCountry" type="string">
      Country of headquarters.
    </ResponseField>

    <ResponseField name="annualRevenue" type="string">
      Estimated annual revenue figure.
    </ResponseField>

    <ResponseField name="publiclyTradedSymbol" type="string">
      Stock ticker symbol, if publicly traded.
    </ResponseField>

    <ResponseField name="publiclyTradedExchange" type="string">
      Stock exchange (e.g., `NASDAQ`, `NYSE`), if applicable.
    </ResponseField>

    <ResponseField name="specialities" type="array">
      Areas of company specialization.
    </ResponseField>

    <ResponseField name="totalFunding" type="string">
      Total funding raised to date.
    </ResponseField>

    <ResponseField name="latestFundingRoundDate" type="date">
      Date of the most recent funding round.
    </ResponseField>

    <ResponseField name="latestFundingStage" type="string">
      Stage of the most recent funding round (e.g., `Series B`).
    </ResponseField>

    <ResponseField name="numOfAcquisitions" type="string">
      Total number of acquisitions made by this company.
    </ResponseField>

    <ResponseField name="numOfSubsidaries" type="string">
      Total number of subsidiaries.
    </ResponseField>

    <ResponseField name="dateUpdated" type="date">
      Date this record was last updated in Clodura's database.
    </ResponseField>
  </Expandable>

  <Expandable title="acquisitionList — returned when includeAcquisitions is true">
    <ResponseField name="id" type="string">
      Unique ID of the acquisition event.
    </ResponseField>

    <ResponseField name="acquireeName" type="string">
      Name of the acquired company.
    </ResponseField>

    <ResponseField name="announcedDate" type="date">
      Date the acquisition was publicly announced.
    </ResponseField>

    <ResponseField name="price" type="integer">
      Acquisition price in USD, if disclosed.
    </ResponseField>
  </Expandable>

  <Expandable title="fundingEvents — returned when includeFunding is true">
    <ResponseField name="id" type="string">
      Unique ID of the funding event.
    </ResponseField>

    <ResponseField name="round_type" type="string">
      Type of funding round (e.g., `Series A`, `Seed Round`).
    </ResponseField>

    <ResponseField name="investors" type="string">
      Names of investors who participated in this round.
    </ResponseField>

    <ResponseField name="date" type="date">
      Date of the funding event.
    </ResponseField>

    <ResponseField name="fundingAmount" type="string">
      Amount raised in this round (in USD).
    </ResponseField>
  </Expandable>

  <Expandable title="technographics — returned when includeTechnographics is true">
    <ResponseField name="technologies" type="array">
      Technologies currently in use (e.g., `5G`, `Cloud Computing`, `IoT`).
    </ResponseField>

    <ResponseField name="programmingLanguages" type="array">
      Programming languages detected in use (e.g., `Python`, `JavaScript`).
    </ResponseField>

    <ResponseField name="operatingSystem" type="array">
      Operating systems used (e.g., `Linux`, `Windows`, `MacOS`).
    </ResponseField>

    <ResponseField name="products" type="array">
      Third-party software products in use (e.g., `Salesforce`, `AWS`, `Google Analytics`).
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "organisation": {
    "id": "org_98765",
    "name": "Circuitry AI",
    "websiteUrl": "https://circuitry.ai",
    "linkedinUrl": "https://www.linkedin.com/company/circuitry-ai/",
    "primaryDomain": "circuitry.ai",
    "description": "AI-driven solutions for modern businesses.",
    "foundedYear": "2018",
    "industry": ["Technology"],
    "estimatedNumEmployees": "51-200",
    "companyPhoneNumbers": ["+1-555-0123"],
    "companyEmails": ["contact@circuitry.ai"],
    "hqRawAddress": "123 AI Lane, San Francisco, CA 94105",
    "hqCity": "San Francisco",
    "hqState": "California",
    "hqPostalCode": "94105",
    "hqCountry": "USA",
    "annualRevenue": "12200000",
    "totalFunding": "50000000",
    "latestFundingRoundDate": "2023-10-15",
    "latestFundingStage": "Series B",
    "numOfAcquisitions": "2",
    "numOfSubsidaries": "3",
    "acquisitionList": [
      {
        "id": "acq_001",
        "acquireeName": "DataTech Inc.",
        "announcedDate": "2022-05-20",
        "price": 350000000
      }
    ],
    "fundingEvents": [
      {
        "id": "fund_881",
        "round_type": "Series A",
        "investors": "Sequoia Capital",
        "date": "2022-05-20",
        "fundingAmount": "15000000"
      }
    ],
    "technographics": {
      "technologies": ["Cloud Computing", "5G"],
      "programmingLanguages": ["Python", "JavaScript"],
      "operatingSystem": ["Linux", "MacOS"],
      "products": ["Salesforce", "AWS", "Google Analytics"]
    }
  }
}
```

## Error Codes

| Status | Meaning                                                                 |
| ------ | ----------------------------------------------------------------------- |
| `400`  | Bad request — malformed input or domain count exceeded                  |
| `401`  | Unauthorized — your API key is missing or invalid                       |
| `402`  | Payment required — credits exhausted; upgrade your plan or add credits  |
| `403`  | Forbidden — this endpoint requires a paid Clodura plan                  |
| `404`  | Not found — no enrichment data available for this organization          |
| `409`  | Daily rate limit reached — maximum API calls for this endpoint exceeded |
| `422`  | Unprocessable entity — missing required identifier or invalid parameter |
| `429`  | Rate limit exceeded — reduce request frequency or upgrade your plan     |