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

# Search and Discover Companies in Clodura's Database

> Discover organizations in Clodura's B2B database by industry, revenue, headcount, location, and technology stack to build targeted account lists.

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](/api/company/enrich-company), [Job Posts](/api/company/job-posts), and [Company News](/api/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.

<Note>
  At least one filter parameter is required (e.g., `organisationName`, `domain`, `industry`, or `organisationCountry`). Requests with no filters will be rejected.
</Note>

## Endpoint

`POST /api/v1/organisation/search`

## Request

### Headers

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

### Body Parameters

<ParamField body="organisationId" type="array">
  One or more Clodura company IDs to include in your search. Use this to retrieve specific known companies.
</ParamField>

<ParamField body="domain" type="string">
  The company's primary domain name (e.g., `clodura.ai`). Do not include `www.`, `@`, or any path.
</ParamField>

<ParamField body="organisationName" type="string">
  The legal or common name of the organization to search for.
</ParamField>

<ParamField body="organisationCity" type="array">
  Filter by one or more cities where the company is headquartered. Refer to the [supported cities list](https://kb.clodura.ai/assets/files/city-0e179bb959324f64595aefc1197c7b63.txt).
</ParamField>

<ParamField body="organisationState" type="array">
  Filter by one or more states. Refer to the [supported states list](https://kb.clodura.ai/assets/files/state-18aa91fd534fa5f0e375cab69820ba76.txt).
</ParamField>

<ParamField body="organisationCountry" type="array">
  Filter by one or more countries. Refer to the [supported countries list](https://kb.clodura.ai/assets/files/country-bac0b920e008f616e8d3b86a9a593d6d.txt).
</ParamField>

<ParamField body="includeAllOffice" type="boolean">
  When `true`, includes companies with any matching office location rather than only headquarters. Defaults to `false`.
</ParamField>

<ParamField body="industry" type="array">
  Filter by industry sector. Refer to the [supported industries list](https://kb.clodura.ai/assets/files/industries-e4d3738a2ffe956b2ed7a739c4089370.txt).
</ParamField>

<ParamField body="industryKeywords" type="array">
  Specialized industry keywords or company specialties (e.g., `AI`, `FinTech`, `SaaS`).
</ParamField>

<ParamField body="businessModel" type="array">
  Filter by primary business model. Accepted values: `Product`, `Service`, `Solutions`.
</ParamField>

<ParamField body="revenue" type="array">
  Filter by estimated annual revenue bracket. Accepted values: `< 1M`, `1M-10M`, `11M-100M`, `101M-500M`, `501M-1B`, `1B+`.
</ParamField>

<ParamField body="organisationEmployeeSize" type="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.
</ParamField>

<ParamField body="webKeywords" type="array">
  Keywords found on the company's public website content (e.g., `CRM`, `machine learning`, `compliance`).
</ParamField>

<ParamField body="technologyParameters" type="array">
  Technologies used by the company. Refer to the [supported technologies list](https://kb.clodura.ai/assets/files/technologies-7c729a9de68c94e8076bf96b79c73e0b.txt).
</ParamField>

<ParamField body="page" type="integer">
  Page number for pagination. Maximum: `500`.
</ParamField>

<ParamField body="perPage" type="integer">
  Number of results to return per page. Maximum: `100`.
</ParamField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  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
    }'
  ```

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

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

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

  payload = {
      "industry": ["Technology"],
      "organisationCountry": ["United States"],
      "revenue": ["11M-100M"],
      "organisationEmployeeSize": ["51 - 200"],
      "businessModel": ["Product"],
      "page": 1,
      "perPage": 20
  }

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

## Response

A successful `200` response returns a paginated list of matching organizations.

<ResponseField name="pagination" type="object">
  <Expandable title="pagination fields">
    <ResponseField name="page" type="integer">
      The current page number.
    </ResponseField>

    <ResponseField name="per_page" type="integer">
      Number of records returned per page.
    </ResponseField>

    <ResponseField name="total_entries" type="integer">
      Total number of companies matching your filters.
    </ResponseField>

    <ResponseField name="total_pages" type="integer">
      Total number of pages available.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="organisations" type="array">
  <Expandable title="organisation object fields">
    <ResponseField name="id" type="string">
      Clodura's unique identifier for the company. Use this value as `organisationId` in [Enrich Company](/api/company/enrich-company), [Job Posts](/api/company/job-posts), and [Company News](/api/company/news) requests.
    </ResponseField>

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

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

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

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

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

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

    <ResponseField name="city" type="string">
      City of the company's headquarters.
    </ResponseField>

    <ResponseField name="state" type="string">
      State of the company's headquarters.
    </ResponseField>

    <ResponseField name="country" type="string">
      Country of the company's headquarters.
    </ResponseField>

    <ResponseField name="description" type="string">
      A short description of the company.
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "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..."
    }
  ]
}
```

<Tip>
  Save the `id` field from search results — you will need it as `organisationId` in all subsequent company-level API calls.
</Tip>

## Error Codes

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