Company Search APIs

Company Search APIs allow you to discover and retrieve companies that match custom business criteria (such as industry, location, size, and intent signals) through AI-powered search and structured filtering.

Overview

The Company Search system runs asynchronous agent workflows so you can launch or refine searches, track progress, read results, manage tenant lists, run company enrichment, and query companies directly from MongoDB via Atlas Search.

The workflow includes:

Start or Continue – Begin a new company search with a prompt, or extend an existing workflow by supplying its thread_id and a total_target
Monitor status – Poll GET /status/{task_id} with the thread_id returned from start or continue to fetch the current workflow snapshot (criteria, table structure, rows, state)
Get results & lists – Fetch search results for a thread_id and retrieve all lists for the current tenant
Company enrichment – Start or stop asynchronous company enrichment workflows
Search companies – Query companies from MongoDB using Atlas Search with structured filters
Stop – Cancel an in-flight company search using the workflow thread_id

Base URL: https://chordian-core.chordian.ai

Authentication: Bearer token (HTTPBearer) or API key cookie (APIKeyCookie). Send your API key in the header: Authorization: Bearer <api-key>.

Start Company Search

Start a company search workflow.

The body must include a string prompt. The API forwards {"prompt": ...} to the agent service via celery_task.execute_function with function_name="start_workflow". The workflow runs in the background; use the returned thread_id to poll status.

POST /company-search/start

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "list_description": "Series B SaaS companies",
  "list_name": "Q3 prospects",
  "prompt": "Find Series B SaaS companies in the US",
  "search_mode": "fast"
}

Field	Type	Required	Description
`prompt`	string	✅	Natural-language description of the companies you want to find.
`list_description`	string	❌	Human-readable description for the resulting list.
`list_name`	string	❌	Name for the resulting list.
`search_mode`	string	❌	Search mode (e.g. `fast`).

Successful Response (200 OK)

{
  "success": true,
  "message": "string",
  "thread_id": "string",
  "status": "processing"
}

Field	Type	Description
`success`	boolean	`true` when the workflow was started successfully.
`message`	string	Human-readable status message.
`thread_id`	string	Workflow thread identifier. Pass this as `task_id` to Get Workflow Status (`GET /company-search/status/{task_id}`), or use with Continue / Stop.
`status`	string	Workflow state (e.g. `processing`).

Validation Error (422)

{
  "status_code": 422,
  "message": "Request validation failed",
  "errors": [
    {
      "field": "body.prompt",
      "message": "Field required",
      "type": "missing"
    }
  ],
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/company-search/start" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "list_description": "Series B SaaS companies",
    "list_name": "Q3 prospects",
    "prompt": "Find Series B SaaS companies in the US",
    "search_mode": "fast"
  }'

Continue Company Search

Continue an existing company search workflow.

The body must include thread_id and total_target. The API forwards that JSON to the agent service via celery_task.execute_function with function_name="continue_workflow".

POST /company-search/continue

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "thread_id": "thread_abc123",
  "total_target": 200
}

Field	Type	Required	Description
`thread_id`	string	✅	Identifier of the existing workflow thread to continue (the `thread_id` returned by Start Company Search).
`total_target`	integer	✅	Target total number of companies the workflow should aim to collect.

Successful Response (200 OK)

{
  "success": true,
  "thread_id": "string",
  "status": "continuing"
}

Field	Type	Description
`success`	boolean	`true` when the continue request was accepted.
`thread_id`	string	Workflow thread identifier. Pass this as `task_id` to Get Workflow Status (`GET /company-search/status/{task_id}`).
`status`	string	Workflow state (e.g. `continuing`).

Validation Error (422)

{
  "status_code": 422,
  "message": "Request validation failed",
  "errors": [
    {
      "field": "body.thread_id",
      "message": "Field required",
      "type": "missing"
    },
    {
      "field": "body.total_target",
      "message": "Field required",
      "type": "missing"
    }
  ],
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/company-search/continue" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "thread_id": "thread_xyz789",
    "total_target": 200
  }'

Get Workflow Status

Poll the status of a previously started workflow. Returns a snapshot of the workflow (criteria, table structure, rows, etc.) for the given task_id — which is a workflow thread id (the thread_id returned by Start Company Search or Continue Company Search).

GET /company-search/status/{task_id}

Authentication: Authorization: Bearer <api-key>

Path Parameters

Parameter	Type	Required	Description
`task_id`	string	✅	Workflow task or thread id for status polling. Use the `thread_id` returned by Start or Continue.

Successful Response (200 OK)

A full snapshot of the workflow — overall status, search criteria, the result table (columns + rows), collected companies, and progress counters.

{
  "success": true,
  "thread_id": "string",
  "current_step": "string",
  "category": "string",
  "criteria": [
    {
      "name": "string",
      "value": "string",
      "column_name": "string",
      "columnType": "string",
      "description": "string",
      "type": "string",
      "width": 0,
      "maxWidth": 0,
      "minWidth": 0
    }
  ],
  "error_message": "string",
  "total_target": 0,
  "table_structure": {
    "columns": [
      {
        "id": "string",
        "header": "string",
        "type": "fixed",
        "width": 0,
        "required": true,
        "columnType": "string",
        "dataType": "string",
        "maxWidth": 0,
        "minWidth": 0
      }
    ],
    "rows": [
      {
        "id": "string",
        "cells": {
          "additionalProp1": {
            "row_id": "string",
            "column_id": "string",
            "value": "string",
            "status": "string",
            "metadata": {
              "additionalProp1": {}
            },
            "expandable": false
          }
        },
        "step_source": "string",
        "metadata": {
          "additionalProp1": {}
        }
      }
    ],
    "total_target": 0,
    "current_count": 0
  },
  "all_companies": [
    {
      "additionalProp1": {}
    }
  ],
  "step_companies": {
    "additionalProp1": {}
  },
  "title": "string",
  "description": "string",
  "goal": "string",
  "processed_companies": ["string"]
}

Top-level fields

Field	Type	Description
`success`	boolean	`true` when the snapshot was produced successfully. Check `error_message` when `false`.
`thread_id`	string	Identifier of this workflow thread.
`current_step`	string	Name of the step the workflow is currently executing.
`category`	string	Workflow category / classification assigned by the agent.
`criteria`	array<Criterion>	Filtering / scoring criteria (see Criterion).
`error_message`	string	Error description when the workflow fails; empty or null otherwise.
`total_target`	integer	Target total number of records the workflow aims to collect.
`table_structure`	object<TableStructure>	Schema and current contents of the result table (see TableStructure).
`all_companies`	array<object>	All companies discovered across the workflow.
`step_companies`	object	Map of step name → companies surfaced in that step.
`title`	string	Human-readable title for the workflow / result set.
`description`	string	Human-readable description of the workflow / result set.
`goal`	string	Goal statement for the workflow.
`processed_companies`	array<string>	Identifiers of companies the workflow has processed so far.

Criterion (item of `criteria[]`)

Field	Type	Description
`name`	string	Criterion name.
`value`	string	Current value / target for the criterion.
`column_name`	string	Result-table column this criterion maps to.
`columnType`	string	UI column-type hint.
`description`	string	Human-readable description.
`type`	string	Internal criterion type.
`width`	integer	Default column width (pixels).
`maxWidth`	integer	Maximum column width.
`minWidth`	integer	Minimum column width.

TableStructure (`table_structure`)

Field	Type	Description
`columns`	array<Column>	Column definitions (see Column).
`rows`	array<Row>	Rows collected so far (see Row).
`total_target`	integer	Target row count for this table.
`current_count`	integer	Number of rows currently in the table.

Column (item of `table_structure.columns[]`)

Field	Type	Description
`id`	string	Stable column identifier (used as `cells` key on each row).
`header`	string	Display label for the column.
`type`	string	Column type — typically `fixed` or dynamic-criterion columns.
`width`	integer	Default column width (pixels).
`required`	boolean	Whether the column must be populated for a complete row.
`columnType`	string	UI column-type hint.
`dataType`	string	Underlying data type for cell values.
`maxWidth`	integer	Maximum column width.
`minWidth`	integer	Minimum column width.

Row (item of `table_structure.rows[]`)

Field	Type	Description
`id`	string	Stable row identifier.
`cells`	object<string, Cell>	Map of column id → cell value (see Cell).
`step_source`	string	Workflow step that produced this row.
`metadata`	object	Arbitrary per-row metadata.

Cell (value in `Row.cells`)

Field	Type	Description
`row_id`	string	Parent row identifier.
`column_id`	string	Column this cell belongs to.
`value`	string	Cell value, serialized as a string.
`status`	string	Cell status (e.g. `pending`, `loaded`, `error`).
`metadata`	object	Arbitrary per-cell metadata.
`expandable`	boolean	`true` when a drill-down view is available.

Validation Error (422)

{
  "status_code": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "path.task_id",
      "message": "Field required",
      "type": "missing"
    }
  ],
  "data": null
}

Example

curl "https://chordian-core.chordian.ai/company-search/status/thread_xyz789" \
  -H "Authorization: Bearer <api-key>"

Stop Company Search

Stop a running company search workflow.

The path thread_id is forwarded to the agent service via celery_task.execute_function with function_name="stop_workflow".

POST /company-search/stop/{thread_id}

Authentication: Authorization: Bearer <api-key>

Path Parameters

Parameter	Type	Required	Description
`thread_id`	string	✅	Company workflow thread identifier (the `thread_id` returned by Start or Continue).

Successful Response (200 OK)

{
  "success": true,
  "thread_id": "string",
  "status": "stopping",
  "message": "string"
}

Field	Type	Description
`success`	boolean	`true` when the stop request was accepted.
`thread_id`	string	Workflow thread identifier that is being stopped.
`status`	string	Workflow state (e.g. `stopping`).
`message`	string	Human-readable status message.

Validation Error (422)

{
  "status_code": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "path.thread_id",
      "message": "Field required",
      "type": "missing"
    }
  ],
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/company-search/stop/thread_abc123" \
  -H "Authorization: Bearer <api-key>"

Start Company Enrichment

Start a company enrichment workflow.

POST /company-search/start-enrichment

Authentication: Authorization: Bearer <api-key>

Request Body

Schema: CompanyEnrichmentStartRequest

{
  "thread_id": "thread_xyz",
  "column_name": "ceo_email",
  "instruction": "Find the CEO work email",
  "enrichment_type": "custom",
  "data_type": "company"
}

Field	Type	Required	Description
`thread_id`	string	✅	Workflow thread identifier for the company search to enrich.
`column_name`	string	✅	Target column name in the workflow result table to enrich.
`instruction`	string	❌	Natural-language instruction describing what to enrich (default: `""`).
`enrichment_type`	string	❌	Enrichment variant (e.g. `custom`, `contacts`; default: `""`).
`data_type`	string	❌	Optional data type hint (e.g. `company`).

Successful Response (200 OK)

Schema: CompanyEnrichmentTaskResponse

{}

Field	Type	Description
(schema)	object	Enrichment task details. Shape defined by `CompanyEnrichmentTaskResponse`.

Validation Error (422)

{
  "status_code": 422,
  "message": "Request validation failed",
  "errors": [
    {
      "field": "body.thread_id",
      "message": "Field required",
      "type": "missing"
    },
    {
      "field": "body.column_name",
      "message": "Field required",
      "type": "missing"
    }
  ],
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/company-search/start-enrichment" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "thread_id": "thread_xyz",
    "column_name": "ceo_email",
    "instruction": "Find the CEO work email",
    "enrichment_type": "custom",
    "data_type": "company"
  }'

Stop Company Enrichment

Stop a running company enrichment workflow.

POST /company-search/stop-enrichment/{thread_id}

Authentication: Authorization: Bearer <api-key>

Path Parameters

Parameter	Type	Required	Description
`thread_id`	string (1–512 chars)	✅	Company workflow thread identifier for the enrichment run to stop.

Successful Response (200 OK)

Schema: CompanyEnrichmentTaskResponse

{}

Field	Type	Description
(schema)	object	Enrichment task details. Shape defined by `CompanyEnrichmentTaskResponse`.

Validation Error (422)

{
  "status_code": 422,
  "message": "Validation Error",
  "errors": [],
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/company-search/stop-enrichment/thread_abc123" \
  -H "Authorization: Bearer <api-key>"

Get Lists

Get all lists for the current tenant.

The request is forwarded to the agent service via celery_task.execute_function with function_name="get_lists".

GET /company-search/getLists

Authentication: Authorization: Bearer <api-key>

Successful Response (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "string",
      "listLinkID": "string",
      "createdAt": "string",
      "listDescription": "string",
      "listName": "string",
      "listStatus": "string",
      "listType": "string",
      "noOfRecords": 0,
      "title": "string",
      "subtitle": "string",
      "author": 0,
      "type": "string"
    }
  ],
  "total": 0
}

Field	Type	Description
`success`	boolean	`true` when lists were retrieved successfully.
`data`	array<ListItem>	List records for the current tenant (see ListItem).
`total`	integer	Total number of lists returned.

ListItem (item of `data[]`)

Field	Type	Description
`id`	string	List identifier.
`listLinkID`	string	Linked list ID.
`createdAt`	string	ISO timestamp when the list was created.
`listDescription`	string	List description.
`listName`	string	List name.
`listStatus`	string	Current list status.
`listType`	string	List type classification.
`noOfRecords`	integer	Number of records in the list.
`title`	string	Display title.
`subtitle`	string	Display subtitle.
`author`	integer	Author identifier.
`type`	string	Type label.

Validation Error (422)

{
  "status_code": 422,
  "message": "Validation Error",
  "errors": [],
  "data": null
}

Example

curl "https://chordian-core.chordian.ai/company-search/getLists" \
  -H "Authorization: Bearer <api-key>"

Get Search Result

Get the search result for a given thread.

GET /company-search/getSearchResult/{thread_id}

Authentication: Authorization: Bearer <api-key>

Path Parameters

Parameter	Type	Required	Description
`thread_id`	string	✅	Company workflow thread identifier

Successful Response (200 OK)

{
  "success": true,
  "thread_id": "string",
  "list_id": "string",
  "status": "string",
  "list_name": "string",
  "list_description": "string",
  "list_type": "string",
  "total_target": 0,
  "criteria": [
    {
      "name": "string",
      "value": "string",
      "column_name": "string",
      "type": "string"
    }
  ],
  "results": [
    {
      "additionalProp1": {}
    }
  ],
  "count": 0,
  "created_at": "string",
  "updated_at": "string"
}

Field	Type	Description
`success`	boolean	`true` when the result was retrieved successfully.
`thread_id`	string	Workflow thread identifier.
`list_id`	string	Associated list identifier.
`status`	string	Result / workflow status.
`list_name`	string	Name of the list.
`list_description`	string	Description of the list.
`list_type`	string	List type classification.
`total_target`	integer	Target number of records for this search.
`criteria`	array<object>	Criteria used for the search (each item has `name`, `value`, `column_name`, `type`).
`results`	array<object>	Company result rows (open shape per item).
`count`	integer	Number of results returned.
`created_at`	string	ISO timestamp when the result was created.
`updated_at`	string	ISO timestamp when the result was last updated.

Validation Error (422)

{
  "status_code": 422,
  "message": "Validation Error",
  "errors": [],
  "data": null
}

Example

curl "https://chordian-core.chordian.ai/company-search/getSearchResult/thread_abc123" \
  -H "Authorization: Bearer <api-key>"

Search Companies

Search companies from MongoDB using Atlas Search. Pass one or more field name values in the path array to control which attributes are matched against your query.

For nested fields, use the full dot-notation name from the table below (for example, links.linkedin or address.city). Some shorthand values may also resolve automatically—for example, linkedin can map to links.linkedin.

Searchable attributes

Use the Name column values in your request path array.

Name	Label	Description
`country`	HQ (Country/City)	Headquarters location of the company, typically including country and city information used to identify where the business is based.
`phone`	Company Phone	The company’s primary contact phone number used for business communication.
`revenue`	Revenue	The total amount of money a company earns from its business activities over a given period.
`description`	Description	A brief summary of the company, its products, services, and overall business focus.
`industries`	Industry	The sectors or fields in which the company operates, such as technology, healthcare, or finance.
`ticker`	Ticker	The stock symbol representing the company on a public stock exchange.
`yearFounded`	Year Founded	The calendar year in which the company was officially established.
`fax`	Fax	The company’s fax number used for sending documents and formal communications.
`fundingInvestors`	Funding Investors	Individuals or organizations that have provided financial investment to the company.
`techstack`	Tech Stack	The set of technologies, platforms, and tools the company uses to build and deliver its products or services.
`competitors`	Competitors	Other companies offering similar products or services in the same market.
`totalEmployees`	Total Employees	The total number of people currently employed by the company.
`links.linkedin`	LinkedIn	The company’s official LinkedIn profile or company page URL.
`links.twitter`	Twitter	The company’s official Twitter profile or handle.
`links.facebook`	Facebook	The company’s official Facebook page or profile URL.
`links.crunchbase`	Crunchbase URL	The company’s Crunchbase profile URL, including funding history, investors, and key company details.
`address.street`	Street	The street address of the company’s headquarters or primary business location.
`address.city`	City	The city where the company is headquartered or primarily operates.
`address.region`	Region	The state, province, or broader geographic region where the company is located.
`address.postal_code`	Postal Code	The ZIP or postal code for the company’s address.
`address.country_code`	Country Code	The ISO country code representing the country where the company is located.
`departments`	Departments	The functional units or teams within the company, such as sales, engineering, or marketing.
`ownershipType`	Ownership Type	Indicates who owns and controls the company—for example, private individuals, public shareholders, or government entities.
`tags`	Tags	Short keywords or labels describing key company attributes such as industry, size, ownership type, services, or business model.
`googleReviewCount`	Google Review Count	The total number of customer reviews the company has received on Google.
`email`	Company Email	The official email address used for business communication with the company.
`staffs`	Staffs	The total number of employees or staff members working at the company.
`googleRating`	Google Rating	The average customer rating (typically 1–5 stars) the company has received on Google.
`noOfStores`	No of Stores	The number of physical retail locations or outlets the company operates.
`yelpReviewCount`	Yelp Review Count	The total number of customer reviews the company has received on Yelp.
`links.googleMap`	Google Map	The company’s Google Maps listing, including address, directions, and location details.
`priceTier`	Price Tier	The pricing level or category associated with the company’s products or services (for example, budget, mid-range, or premium).
`openDate`	Open Date	The date when the company, store, or branch officially began operations.
`links.instagram`	Instagram	The company’s official Instagram account used for marketing and customer engagement.
`links.x`	X	The company’s official X (formerly Twitter) account for updates and public engagement.
`links.pinterest`	Pinterest	The company’s official Pinterest account for sharing visual content and promotions.
`links.tiktok`	TikTok	The company’s official TikTok account for short-form video content and audience engagement.
`links.youtube`	YouTube	The company’s official YouTube channel for videos, promotions, tutorials, and viewer engagement.
`businessSpecialty`	Business Specialty	The main products, services, or areas of expertise the company is known for.
`latitude`	Latitude	The geographic coordinate specifying the company’s north–south position on Earth’s surface.
`longitude`	Longitude	The geographic coordinate specifying the company’s east–west position on Earth’s surface.
`sectorFocus`	Sector Focus	The key industry sectors the company targets with its products, services, and solutions.
`timeZone`	Time Zone	The official local time zone used by the company for business operations and communication.
`companyType`	Company Type	The legal form of the business—for example, corporation, partnership, private limited company, or government entity.
`marketCap`	Market Cap	The total market value of the company’s outstanding shares, indicating its size in financial markets.
`estimatedAnnualRevenue`	Estimated Annual Revenue	A projected or approximate yearly income generated from the company’s core business operations.
`fiscalYearEnd`	Fiscal Year End	The last day of the company’s financial year, after which annual financial statements are prepared.
`fundingRounds`	Funding Rounds	Details of individual funding rounds the company has completed, including stage and amounts raised.
`fundingTotals`	Funding Totals	The cumulative amount of investment the company has secured across all funding rounds.
`lastFundingType`	Last Funding Type	The type or stage of the company’s most recent funding round (for example, Seed, Series A, or Series B).
`lastFundingAt`	Last Funding At	The date of the company’s most recent investment or funding round.
`numFundingRounds`	No of Funding Rounds	The total number of separate funding rounds the company has received from investors.
`trafficRankHeadline`	Traffic Rank Headline	A summary headline describing the company’s website traffic rank and online visibility.
`spentSummary`	Spent Summary	A concise overview of the total amount the company has spent over a period or on specific activities.
`fundingStage`	Funding Stage	The company’s current or latest stage in its fundraising journey (for example, Seed, Series A, or Series B).
`trafficSummary`	Traffic Summary	A concise overview of the company’s website traffic and online engagement metrics over time.
`investorList`	Investor List	A record of individuals or organizations that have invested capital in the company across its funding rounds.
`acquiredCompanies`	Acquired Companies	Companies that have been acquired or merged by this organization.
`subOrganizationsList`	Sub Organizations List	Subsidiary or affiliated organizations operating under the parent company.
`traffic.trafficCountry`	Traffic Country	The country or countries from which the company’s website receives the majority of its traffic.
`traffic.trafficPercentage`	Traffic Percentage	The proportion of website traffic from a specific source, country, or segment, expressed as a percentage.
`averageInvestmentTicket`	Average Investment Ticket	The average amount invested in a single funding round.
`similarCompaniesInvestedIn`	Historical Investments	A record of previous investments the company or investor has made in other businesses.
`investmentThesis`	Investment Thesis	The primary reasoning, strategy, or criteria behind investment decisions.
`traffic.monthlyWebsiteVisitors`	Monthly Website Visitors	The total number of unique users who visit the company’s website within a month.
`itSpend`	IT Spend	Total expenditure on IT resources, infrastructure, software, and related services.
`interestSignals`	Interest Signals	Indicators of the company’s digital research behavior and topics they are actively exploring online.
`totalIp`	Total IP	The total number of unique IP addresses accessing the company’s website or network.
`investorType`	Investor Type	The category of investor based on structure and strategy—for example, venture capital, angel, or corporate investor.
`companyName`	Company Name	The legal or commonly used name of the company or organization.
`website`	Website	The company’s primary website URL or domain.
`naics.naics_code`	NAICS Code	A 6-digit North American Industry Classification System code identifying the company’s industry.
`naics.sector`	NAICS Sector	The highest-level NAICS grouping describing the broad sector the company belongs to.
`naics.sub_sector`	NAICS Sub Sector	The 3-digit NAICS sub-sector classification for the company.
`naics.industry_group`	NAICS Industry Group	The 4-digit NAICS industry group classification for the company.
`naics.naics_industry`	NAICS Industry	The 5-digit NAICS industry classification for the company.
`naics.national_industry`	NAICS National Industry	The most detailed 6-digit NAICS classification for the company’s national industry.
`sic.sic_code`	SIC Code	A 4-digit Standard Industrial Classification code identifying the company’s industry.
`sic.major_group`	SIC Major Group	The 2-digit SIC major group classification for the company.
`sic.industry_group`	SIC Industry Group	The 3-digit SIC industry group classification for the company.
`sic.industry_sector`	SIC Industry Sector	The top-level SIC division or sector the company belongs to.
`profiles`	Company Profiles	Online profile links and references related to the company across platforms and directories.
`mic_exchange`	MIC Exchange	The Market Identifier Code (ISO 10383) for the stock exchange or trading venue where the company is listed.

POST /company-search/search

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "fuzzy_max_edits": 2,
  "limit": 10,
  "path": ["website", "companyName"],
  "query": "amossoftware.com"
}

Field	Type	Required	Description
`query`	string	✅	Search query string (e.g. domain, company name, or keyword).
`limit`	integer	✅	Maximum number of results to return.
`path`	array<string>	✅	One or more searchable field `name` values from the table above (e.g. `website`, `companyName`, `links.linkedin`).
`fuzzy_max_edits`	integer	❌	Maximum edit distance for fuzzy matching (e.g. `2`).

Successful Response (200 OK)

{
  "results": [
    {
      "_id": "string",
      "website": "string",
      "country": "string",
      "headquarters": "string",
      "similarCompaniesInvestedIn": []
    }
  ],
  "count": 0
}

Field	Type	Description
`results`	array<object>	Matching company documents (open shape per item).
`count`	integer	Number of results returned.

Validation Error (422)

{
  "status_code": 422,
  "message": "Request validation failed",
  "errors": [
    {
      "field": "body.query",
      "message": "Field required",
      "type": "missing"
    }
  ],
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/company-search/search" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "fuzzy_max_edits": 2,
    "limit": 10,
    "path": ["website", "companyName"],
    "query": "amossoftware.com"
  }'

Overview People Search APIs

Company Search APIs

Overview

Start Company Search

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Continue Company Search

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Get Workflow Status

Path Parameters

Successful Response (200 OK)

Top-level fields

Criterion (item of criteria[])

TableStructure (table_structure)

Column (item of table_structure.columns[])

Row (item of table_structure.rows[])

Cell (value in Row.cells)

Validation Error (422)

Example

Stop Company Search

Path Parameters

Successful Response (200 OK)

Validation Error (422)

Example

Start Company Enrichment

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Stop Company Enrichment

Path Parameters

Successful Response (200 OK)

Validation Error (422)

Example

Get Lists

Successful Response (200 OK)

ListItem (item of data[])

Validation Error (422)

Example

Get Search Result

Path Parameters

Successful Response (200 OK)

Validation Error (422)

Example

Search Companies

Searchable attributes

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Criterion (item of `criteria[]`)

TableStructure (`table_structure`)

Column (item of `table_structure.columns[]`)

Row (item of `table_structure.rows[]`)

Cell (value in `Row.cells`)

ListItem (item of `data[]`)