Skip to main content
The Search Organizations endpoint lets you query Clodura’s company database using a broad set of firmographic and technographic filters. You can target companies by industry sector, annual revenue bracket, headcount range, business model, geographic location, website keywords, and technology stack. The endpoint is the starting point for all company-level workflows: the organisationId values returned here are what you pass to the Enrich Company, Job Posts, and Company News endpoints for deeper intelligence. You must supply at least one filter parameter to execute a search — open-ended queries with no filters are not permitted. Results are paginated, and you can retrieve up to 100 records per page across up to 500 pages.
At least one filter parameter is required (e.g., organisationName, domain, industry, or organisationCountry). Requests with no filters will be rejected.

​
Endpoint

POST /api/v1/organisation/search

​
Request

​
Headers

HeaderValue
X-API-KEYYour Clodura API key
Content-Typeapplication/json

​
Body Parameters

​
organisationId
array
One or more Clodura company IDs to include in your search. Use this to retrieve specific known companies.
​
domain
string
The company’s primary domain name (e.g., clodura.ai). Do not include www., @, or any path.
​
organisationName
string
The legal or common name of the organization to search for.
​
organisationCity
array
Filter by one or more cities where the company is headquartered. Refer to the supported cities list.
​
organisationState
array
Filter by one or more states. Refer to the supported states list.
​
organisationCountry
array
Filter by one or more countries. Refer to the supported countries list.
​
includeAllOffice
boolean
When true, includes companies with any matching office location rather than only headquarters. Defaults to false.
​
industry
array
Filter by industry sector. Refer to the supported industries list.
​
industryKeywords
array
Specialized industry keywords or company specialties (e.g., AI, FinTech, SaaS).
​
businessModel
array
Filter by primary business model. Accepted values: Product, Service, Solutions.
​
revenue
array
Filter by estimated annual revenue bracket. Accepted values: < 1M, 1M-10M, 11M-100M, 101M-500M, 501M-1B, 1B+.
​
organisationEmployeeSize
array
Filter by headcount range. Accepted values: 0 - 1, 2 - 10, 11 - 50, 51 - 200, 201 - 500, 501 - 1000, 1001 - 5000, 5001 - 10000, 10000+. Note: values must include spaces around the hyphen.
​
webKeywords
array
Keywords found on the company’s public website content (e.g., CRM, machine learning, compliance).
​
technologyParameters
array
Technologies used by the company. Refer to the supported technologies list.
​
page
integer
Page number for pagination. Maximum: 500.
​
perPage
integer
Number of results to return per page. Maximum: 100.

​
Example Request

curl --request POST \
  --url https://api.clodura.ai/api/v1/organisation/search \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "industry": ["Technology"],
    "organisationCountry": ["United States"],
    "revenue": ["11M-100M"],
    "organisationEmployeeSize": ["51 - 200"],
    "businessModel": ["Product"],
    "page": 1,
    "perPage": 20
  }'

​
Response

A successful 200 response returns a paginated list of matching organizations.
​
pagination
object
​
organisations
array

​
Example Response

{
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_entries": 1250,
    "total_pages": 63
  },
  "organisations": [
    {
      "id": "2389402640191586304",
      "name": "Clodura.AI",
      "primary_domain": "clodura.ai",
      "linkedin_url": "https://www.linkedin.com/company/clodura-ai/",
      "industry": "Technology",
      "founded_year": "2015",
      "organisationEmployeeSize": "51 - 200",
      "city": "Pune",
      "state": "Maharashtra",
      "country": "India",
      "description": "Clodura is an AI-powered sales intelligence platform..."
    }
  ]
}
Save the id field from search results — you will need it as organisationId in all subsequent company-level API calls.

​
Error Codes

StatusMeaning
400Bad request — domain count exceeds 10 or malformed input
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
404No results found — try broadening or adjusting your filters
409Daily rate limit reached — maximum API calls for this endpoint exceeded
422Unprocessable entity — invalid parameter combination or malformed JSON body
429Rate limit exceeded — reduce request frequency or upgrade your plan