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/enrichRequest Header Value X-API-KEYYour Clodura API key Content-Typeapplication/json
Body Parameters Clodura’s unique identifier for the company. Obtain this from the Search Organizations endpoint. Provide either this field or orgLinkedinUrl. Full LinkedIn Company profile URL (e.g., https://www.linkedin.com/company/clodura-ai/). Required if organisationId is not provided.
When true, the response includes the company’s technology stack, programming languages, operating systems, and products in use. Adds 1 credit. Defaults to false.
When true, the response includes a list of companies acquired by the organization and any subsidiary relationships. Adds 1 credit. Defaults to false.
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 — Base Enrichment
cURL — Full Enrichment (all components)
Python
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" }'
Response A successful 200 response returns an organisation object containing all requested data components.
Show Core firmographic fields (always returned)
Clodura’s unique identifier for this organization.
The company’s primary website URL.
The company’s LinkedIn page URL.
The company’s primary web domain.
A description of the company’s business.
Year the company was founded.
Industry sectors the company operates in.
Estimated headcount range (e.g., 51-200).
Company switchboard or main phone numbers.
General contact email addresses for the company.
Full headquarters street address.
Postal code of headquarters.
Estimated annual revenue figure.
Stock ticker symbol, if publicly traded.
Stock exchange (e.g., NASDAQ, NYSE), if applicable.
Areas of company specialization.
Total funding raised to date.
Date of the most recent funding round.
Stage of the most recent funding round (e.g., Series B).
Total number of acquisitions made by this company.
Total number of subsidiaries.
Date this record was last updated in Clodura’s database.
Show acquisitionList — returned when includeAcquisitions is true
Unique ID of the acquisition event.
Name of the acquired company.
Date the acquisition was publicly announced.
Acquisition price in USD, if disclosed.
Show fundingEvents — returned when includeFunding is true
Unique ID of the funding event.
Type of funding round (e.g., Series A, Seed Round).
Names of investors who participated in this round.
Date of the funding event.
Amount raised in this round (in USD).
Show technographics — returned when includeTechnographics is true
Technologies currently in use (e.g., 5G, Cloud Computing, IoT).
Programming languages detected in use (e.g., Python, JavaScript).
Operating systems used (e.g., Linux, Windows, MacOS).
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 400Bad request — malformed input or domain count exceeded 401Unauthorized — your API key is missing or invalid 402Payment required — credits exhausted; upgrade your plan or add credits 403Forbidden — this endpoint requires a paid Clodura plan 404Not found — no enrichment data available for this organization 409Daily rate limit reached — maximum API calls for this endpoint exceeded 422Unprocessable entity — missing required identifier or invalid parameter 429Rate limit exceeded — reduce request frequency or upgrade your plan
