Enrich Company Profiles with Firmographic and Tech Data

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) or an orgLinkedinUrl. If both are provided, organisationId takes precedence.

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

Endpoint

POST /api/v1/organisation/enrich

Request

Headers

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

Body Parameters

string

Clodura’s unique identifier for the company. Obtain this from the Search Organizations endpoint. Provide either this field or orgLinkedinUrl.

string

Full LinkedIn Company profile URL (e.g., https://www.linkedin.com/company/clodura-ai/). Required if organisationId is not provided.

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.

boolean

When true, the response includes a list of companies acquired by the organization and any subsidiary relationships. Adds 1 credit. Defaults to false.

boolean

When true, the response includes all recorded funding events with round type, investors, date, and amount. Adds 1 credit. Defaults to false.

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

Example Request

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"
  }'

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
  }'

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())

Response

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

object

Show Core firmographic fields (always returned)

string

Clodura’s unique identifier for this organization.

string

The company’s name.

string

The company’s primary website URL.

string

The company’s LinkedIn page URL.

string

The company’s primary web domain.

string

A description of the company’s business.

string

Year the company was founded.

array

Industry sectors the company operates in.

string

Estimated headcount range (e.g., 51-200).

array

Company switchboard or main phone numbers.

array

General contact email addresses for the company.

string

Full headquarters street address.

string

City of headquarters.

string

State of headquarters.

string

Postal code of headquarters.

string

Country of headquarters.

string

Estimated annual revenue figure.

string

Stock ticker symbol, if publicly traded.

string

Stock exchange (e.g., NASDAQ, NYSE), if applicable.

array

Areas of company specialization.

string

Total funding raised to date.

date

Date of the most recent funding round.

string

Stage of the most recent funding round (e.g., Series B).

string

Total number of acquisitions made by this company.

string

Total number of subsidiaries.

date

Date this record was last updated in Clodura’s database.

Show acquisitionList — returned when includeAcquisitions is true

string

Unique ID of the acquisition event.

string

Name of the acquired company.

date

Date the acquisition was publicly announced.

integer

Acquisition price in USD, if disclosed.

Show fundingEvents — returned when includeFunding is true

string

Unique ID of the funding event.

string

Type of funding round (e.g., Series A, Seed Round).

string

Names of investors who participated in this round.

date

Date of the funding event.

string

Amount raised in this round (in USD).

Show technographics — returned when includeTechnographics is true

array

Technologies currently in use (e.g., 5G, Cloud Computing, IoT).

array

Programming languages detected in use (e.g., Python, JavaScript).

array

Operating systems used (e.g., Linux, Windows, MacOS).

array

Third-party software products in use (e.g., Salesforce, AWS, Google Analytics).

Example Response

{
  "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

Overview

People API

Company API

Enrich Company Profiles with Firmographic and Tech Data

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

Error Codes

​Endpoint

​Request

​Headers

​Body Parameters

​Example Request

​Response

​Example Response

​Error Codes

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

Error Codes