---
canonical_url: "https://docs.composio.dev/toolkits/cb_insights"
markdown_url: "https://docs.composio.dev/toolkits/cb_insights.md"
product: "platform"
version: null
last_updated: null
---

# CB Insights

CB Insights provides company intelligence, financial transactions, business relationships, predictive analytics, and generated market research through its API.

- **Category:** business intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 17
- **Triggers:** 0
- **Slug:** `CB_INSIGHTS`
- **Version:** 00000000_00

## Tools

### Chat with CBI

**Slug:** `CB_INSIGHTS_CHAT_CBI`

Ask ChatCBI a question or continue a conversation and receive a complete answer with sources, related content, and follow-up suggestions. Optionally use the official streaming route; buffered execution returns its final progressive chunk. Generated answers may contain mistakes; verify important claims against the sources.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chat_id` | string | No | Chat ID returned by a prior call. Provide it to continue that conversation, or omit it to begin a new conversation. |
| `message` | string | Yes | Question or research prompt to send to ChatCBI. |
| `response_mode` | string ("complete" | "streaming") | No | Response route to use. 'complete' waits for the standard response and is the default; 'streaming' calls the official chunked route and returns its final progressively complete response after transport buffering. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Scouting Report

**Slug:** `CB_INSIGHTS_GENERATE_SCOUTING_REPORT`

Generate a complete AI scouting report in JSON and Markdown for one active private company. Optionally use the official streaming route; buffered execution returns its final progressive chunk. The call may take several minutes and consumes limited CB Insights analysis capacity. AI-generated content may contain mistakes; verify important claims against citations and source data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `response_mode` | string ("complete" | "streaming") | No | Response route to use. 'complete' waits for the standard response and is the default; 'streaming' calls the official streaming route and returns its final progressively complete response after transport buffering. |
| `organization_id` | integer | Yes | CB Insights organization ID for an active private company. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Funding History

**Slug:** `CB_INSIGHTS_GET_ORGANIZATION_FUNDING_HISTORY`

Return one organization's funding rounds and cap-table history, including a continuation cursor when more transactions exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum funding transactions to return in this page (1-100). |
| `next_cursor` | string | No | Continuation token returned by a previous call for this organization. |
| `organization_id` | integer | Yes | CB Insights organization ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Management and Board

**Slug:** `CB_INSIGHTS_GET_ORGANIZATION_MANAGEMENT_AND_BOARD`

Return one organization's leadership, board members, education and work history, leadership signals, and Management Mosaic data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title_ids` | array | No | CB Insights title IDs used to filter returned leaders and board members. |
| `organization_id` | integer | Yes | CB Insights organization ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Outlook History

**Slug:** `CB_INSIGHTS_GET_ORGANIZATION_OUTLOOK_HISTORY`

Return historical commercial maturity, exit probability, or Mosaic scores for one CB Insights organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | No | Optional end date in YYYY-MM-DD format for commercial maturity or exit probability. Mosaic history does not accept an end date. |
| `start_date` | string | No | Optional start date in YYYY-MM-DD format. Minimum dates are 2024-07-25 for commercial maturity, 2025-02-25 for exit probability, and 2024-01-01 for Mosaic. |
| `history_type` | string ("commercial_maturity" | "exit_probability" | "mosaic") | Yes | Historical outlook series to return: commercial maturity, exit probability, or Mosaic scores. |
| `organization_id` | integer | Yes | CB Insights organization ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Revenue by Year

**Slug:** `CB_INSIGHTS_GET_ORGANIZATION_REVENUE_BY_YEAR`

Return annual revenue estimates, actual-versus-estimated status, growth, metrics, and source provenance for one CB Insights organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | CB Insights organization ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Strategy Map

**Slug:** `CB_INSIGHTS_GET_STRATEGY_MAP`

Return companies related to one CB Insights organization, grouped by industry with relationship, investment, acquisition, and generated context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | CB Insights organization ID whose strategy map should be returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Business Relationships

**Slug:** `CB_INSIGHTS_LIST_BUSINESS_RELATIONSHIPS`

Return partnerships, client/vendor relationships, licensing activity, and generated insights for either one CB Insights organization or a batch.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call for the same organizations. |
| `organization_id` | integer | No | One CB Insights organization ID. Mutually exclusive with organization_ids. |
| `organization_ids` | array | No | CB Insights organization IDs for a batch request. Mutually exclusive with organization_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Financial Transactions

**Slug:** `CB_INSIGHTS_LIST_FINANCIAL_TRANSACTIONS`

Return one page of funding rounds, investment activity, or portfolio exits using either a single-organization route or a batch of up to 100 organizations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum transaction records to return in this page (1-100). Not supported by the single-organization portfolio-exits route. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. It retains the original transaction type, organization IDs, and limit. |
| `organization_id` | integer | No | One investor organization ID for the single investments or portfolio exits route. Mutually exclusive with organization_ids. |
| `organization_ids` | array | No | One to 100 CB Insights organization IDs for the batch route. For portfolio_exits, provide investor organization IDs. Mutually exclusive with organization_id. |
| `transaction_type` | string ("fundings" | "investments" | "portfolio_exits") | Yes | Financial transaction dataset to return: company fundings, investor participation, or investor portfolio exits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Funding Windows

**Slug:** `CB_INSIGHTS_LIST_FUNDING_WINDOWS`

Return predicted fundraising windows and cohort context for one CB Insights organization or a batch of up to 100 organizations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | No | One CB Insights organization ID. Cannot be combined with organization_ids. |
| `organization_ids` | array | No | One to 100 CB Insights organization IDs. Cannot be combined with organization_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Management and Board

**Slug:** `CB_INSIGHTS_LIST_MANAGEMENT_AND_BOARD`

Return leadership, board members, education and work history, leadership signals, and Management Mosaic data for up to 100 CB Insights organizations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title_ids` | array | No | CB Insights title IDs used to filter returned leaders and board members. |
| `organization_ids` | array | Yes | One to 100 CB Insights organization IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Outlooks

**Slug:** `CB_INSIGHTS_LIST_ORGANIZATION_OUTLOOKS`

Return current commercial maturity, Mosaic scores, and IPO or acquisition exit probabilities for one CB Insights organization or a batch of up to 100 organizations. Organizations without outlook data are omitted by the provider.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | No | One CB Insights organization ID. Cannot be combined with organization_ids. |
| `organization_ids` | array | No | One to 100 CB Insights organization IDs. Cannot be combined with organization_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Revenue by Year

**Slug:** `CB_INSIGHTS_LIST_REVENUE_BY_YEAR`

Return annual revenue estimates, actual-versus-estimated status, growth, metrics, and source provenance for up to 100 CB Insights organizations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_ids` | array | Yes | One to 100 CB Insights organization IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query CBI RAG

**Slug:** `CB_INSIGHTS_QUERY_CBI_RAG`

Run a retrieval-augmented query across CB Insights data and return raw structured data plus guidance. Generated output may contain mistakes; verify pertinent information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Question or research request to run across CB Insights data. Must be between 1 and 9,999 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve Organizations

**Slug:** `CB_INSIGHTS_RESOLVE_ORGANIZATIONS`

Resolve exact organization names, websites, or one CB Insights profile URL to CB Insights organization IDs and basic profiles without consuming documented API credits. Returns one page plus a continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urls` | array | No | Organization websites or domains to resolve. Provide this, names, or profile_url. |
| `limit` | integer | No | Maximum organizations to return in this page (1-100). |
| `names` | array | No | Exact organization names to resolve. Provide this, urls, or profile_url. |
| `next_cursor` | string | No | Continuation token from a previous response. Repeat the same lookup criteria and pass this value back verbatim to fetch the next page. |
| `profile_url` | string | No | One CB Insights profile URL to resolve; mutually exclusive with names and urls. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction for organization-name ordering. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Firmographics

**Slug:** `CB_INSIGHTS_SEARCH_FIRMOGRAPHICS`

Search CB Insights organizations with company, identifier, taxonomy, location, investor, funding, valuation, and headcount filters and return detailed profiles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urls` | array | No | Organization websites to match; partial URL matching is supported. |
| `limit` | integer | No | Maximum organizations to return in this page; the official contract does not publish a maximum. |
| `keyword` | string | No | Fuzzy keyword matched against organization names, descriptions, and aliases. |
| `sort_field` | string ("orgName" | "orgId" | "lastUpdateTime" | "lastFundingDate" | "latestValuation" | "mosaicOverall" | "mosaicManagement" | "mosaicMarket" | "mosaicMomentum" | "mosaicMoney" | "headcountCurrent" | "headcount6MonthGrowth" | "headcount12MonthGrowth" | "headcount24MonthGrowth") | No | Documented field used to order matching organizations. |
| `next_cursor` | string | No | Continuation token returned by a previous call. |
| `max_headcount` | integer | No | Maximum current employee headcount. |
| `min_headcount` | integer | No | Minimum current employee headcount. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction used with sort_field. |
| `venture_backed` | boolean | No | Whether to return only organizations that have received venture funding. |
| `funding_filters` | object | No | Funding-stage, date, amount, and valuation filters flattened to their documented provider keys. |
| `investor_filters` | object | No | Investor-related filters flattened to their documented provider keys. |
| `location_filters` | object | No | Geographic filters flattened to their documented provider keys. |
| `organization_ids` | array | No | CB Insights organization IDs to return; stealth IDs require the Stealth Companies dataset. |
| `taxonomy_filters` | object | No | Provider taxonomy filters flattened to their documented provider keys. |
| `organization_names` | array | No | Organization names to match exactly. |
| `public_identifiers` | object | No | Public-company and security identifiers. These fields are flattened to their provider keys. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Credentials

**Slug:** `CB_INSIGHTS_VALIDATE_CREDENTIALS`

Validate the connected CB Insights client ID and client secret without revealing the credentials or returned bearer token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
