> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CB Insights: Cbinsights Post V2 Firmographics

> List profiles of companies. Includes SDK V2 and CLI requests, input constraints, response fields, and Deepline credit cost.

List profiles of companies.

<Info>
  Tool ID: `cbinsights_post_v2_firmographics`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'cbinsights_post_v2_firmographics',
  {
    "awardsAndSpotlightsIds": [
      123
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute cbinsights_post_v2_firmographics --input '{
  "awardsAndSpotlightsIds": [
    123
  ]
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "nextPageToken": "example",
    "orgs": [
      {
        "businessModels": [
          {}
        ],
        "childOrgs": [
          {}
        ],
        "competitors": [
          {}
        ]
      }
    ],
    "totalHits": 123
  }
}
```

Use `deepline tools get cbinsights_post_v2_firmographics --json` for the latest machine-readable contract.

## Input reference

Search parameters to request a list of organization profiles. You must pass at least one search parameter.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.awardsAndSpotlightsIds` | `array` | No | — | Searches for organizations that are a part of the specified awards and spotlights IDs; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/awards-and-spotlights](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/awards-and-spotlights) Minimum items: 1. |
| `payload.businessModelIds` | `array` | No | — | Searches for organizations that are a part of the specified business model IDs; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/business-models](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/business-models) Minimum items: 1. |
| `payload.ciks` | `array` | No | — | SEC Central Index Keys of organizations to match. Minimum items: 1. |
| `payload.cityIds` | `array` | No | — | CBI city IDs to match; see [https://api-docs.cbinsights.com/docs/reference/address/](https://api-docs.cbinsights.com/docs/reference/address/) Minimum items: 1. |
| `payload.collectionIds` | `array` | No | — | Searches for organizations within these Expert Collections. Minimum items: 1. |
| `payload.continentIds` | `array` | No | — | CBI continent IDs to match; see [https://api-docs.cbinsights.com/docs/reference/address/](https://api-docs.cbinsights.com/docs/reference/address/) Minimum items: 1. |
| `payload.countryIds` | `array` | No | — | CBI country IDs to match; see [https://api-docs.cbinsights.com/docs/reference/address/](https://api-docs.cbinsights.com/docs/reference/address/) Minimum items: 1. |
| `payload.cusips` | `array` | No | — | CUSIPs (Committee on Uniform Security Identification Procedures - North American security identifiers) to match. Minimum items: 1. |
| `payload.figis` | `array` | No | — | Financial Instrument Global Identifiers (also known as OpenFIGI) to match. Minimum items: 1. |
| `payload.fundingInvestorTypeIds` | `array` | No | — | Searches for organizations which have been invested in by these investor types; see [https://api-docs.cbinsights.com/docs/reference/investor\_type/](https://api-docs.cbinsights.com/docs/reference/investor_type/) Minimum items: 1. |
| `payload.industryIds` | `array` | No | — | CBI industry IDs to match; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries) Minimum items: 1. |
| `payload.investorOrgIds` | `array` | No | — | Searches for organizations which have been invested in by these investors. Minimum items: 1. |
| `payload.investorTypeIds` | `array` | No | — | Searches for investor organizations with these investor types; see [https://api-docs.cbinsights.com/docs/reference/investor\_type/](https://api-docs.cbinsights.com/docs/reference/investor_type/) Minimum items: 1. |
| `payload.isins` | `array` | No | — | International Securities Identification Numbers to match. Minimum items: 1. |
| `payload.keyword` | `string` | No | — | Analogous to keyword search on the CB Insights platform. Search term to match against organization names, descriptions, and aliases. Has partial and fuzzy matching; e.g., "robo" will match "Robot," "Robotics," etc., as will "robp." Minimum length: 1. |
| `payload.lastFundingRoundCategoryIds` | `array` | No | — | CBI funding round category IDs of organizations to search for. For a more granular filter, the "lastFundingRoundIds" filter can be used instead; see [https://api-docs.cbinsights.com/docs/reference/funding\_types/](https://api-docs.cbinsights.com/docs/reference/funding_types/) Minimum items: 1. |
| `payload.lastFundingRoundIds` | `array` | No | — | CBI funding round IDs of organizations. This property is used for granular filtering of the stage that most recently occurred. For detailed mapping of Funding Round IDs to investment Stages, see: [https://api-docs.cbinsights.com/docs/reference/funding\_types/#funding-round](https://api-docs.cbinsights.com/docs/reference/funding_types/#funding-round) Minimum items: 1. |
| `payload.leis` | `array` | No | — | Legal Entity Identifiers to match. Minimum items: 1. |
| `payload.limit` | `integer` | No | — | The maximum number of organizations to be returned in a single response. |
| `payload.marketIds` | `array` | No | — | Searches for organizations that are a part of these CB Insights markets; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/markets](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/markets) Minimum items: 1. |
| `payload.marketNames` | `array` | No | — | Searches for organizations that are a part of these CB Insights markets. Supports partial matches, i.e., "AI" will return organizations in markets that include "AI" in their names. Minimum items: 1. |
| `payload.maxCurrentHeadcount` | `integer` | No | — | Filters for organizations with a headcount less than or equal to this value |
| `payload.maxLastFundingDate` | `string` | No | — | Filters for organizations which have received funding on or before the provided date, in the format YYYY-MM-DD. Minimum length: 1. |
| `payload.maxTotalFundingInMillions` | `number` | No | — | Filters for organizations which have received a total amount of funding less than or equal to this value, in millions of US dollars. |
| `payload.maxValuationInMillions` | `number` | No | — | Filters for organizations with a valuation less than or equal to this value, in millions of US dollars. |
| `payload.minCurrentHeadcount` | `integer` | No | — | Filters for organizations with a headcount greater than or equal to this value |
| `payload.minLastFundingDate` | `string` | No | — | Filters for organizations which have received funding on or after the provided date, in the format YYYY-MM-DD. Minimum length: 1. |
| `payload.minTotalFundingInMillions` | `number` | No | — | Filters for organizations which have received a total amount of funding greater than or equal to this value, in millions of US dollars. |
| `payload.minValuationInMillions` | `number` | No | — | Filters for organizations with a valuation greater than or equal to this value, in millions of US dollars. |
| `payload.nextPageToken` | `string` | No | — | Token to fetch the next page of results; provided in a previous response. |
| `payload.orgIds` | `array` | No | — | CB Insights organization IDs to return. Minimum items: 1. |
| `payload.orgNames` | `array` | No | — | Organization names to exactly match. Minimum items: 1. |
| `payload.orgStatusIds` | `array` | No | — | CBI organization status IDs to match; see [https://api-docs.cbinsights.com/docs/reference/org\_status/](https://api-docs.cbinsights.com/docs/reference/org_status/) Minimum items: 1. |
| `payload.regionIds` | `array` | No | — | CBI region IDs to match; see [https://api-docs.cbinsights.com/docs/reference/address/](https://api-docs.cbinsights.com/docs/reference/address/) Minimum items: 1. |
| `payload.sectorIds` | `array` | No | — | CBI sector IDs to match; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries) Minimum items: 1. |
| `payload.sort` | `object` | No | — | The order in which the results will be returned. |
| `payload.stateProvinceIds` | `array` | No | — | CBI state/province IDs to match; see [https://api-docs.cbinsights.com/docs/reference/address/](https://api-docs.cbinsights.com/docs/reference/address/) Minimum items: 1. |
| `payload.subindustryIds` | `array` | No | — | CBI sub-industry IDs to match; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries) Minimum items: 1. |
| `payload.technologyIds` | `array` | No | — | Searches for organizations that are a part of the specified technology IDs; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/technologies](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/technologies) Minimum items: 1. |
| `payload.tickers` | `array` | No | — | Stock tickers to match. Each may optionally include a stock exchange code, separated from the ticker by a colon; see [https://api-docs.cbinsights.com/docs/reference/stock\_exchanges/](https://api-docs.cbinsights.com/docs/reference/stock_exchanges/) for exchange codes. Minimum items: 1. |
| `payload.urls` | `array` | No | — | Websites of organizations to search for. Has partial matching; e.g., "linkedin.com" will match "linkedin.com," "linkedin.com/in/john-doe," and "example-linkedin.com." Minimum items: 1. |
| `payload.vcBacked` | `boolean` | No | — | Boolean flag to match organizations that have received venture funding. |

<Info>
  This input schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get cbinsights_post_v2_firmographics --json`.
</Info>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.nextPageToken` | `string` | No | — | Token to fetch the next page of results. If the value is null, then there are no more results to page through. |
| `result.data.orgs` | `array` | No | — | A list of organization profiles that include general information like location, headcount, and industry, as well as proprietary data like business models, Competitor Scores, and Expert Collections. |
| `result.data.orgs[].businessModels` | `array` | No | — | Business models for the organization. Indicates what markets a business serves and how they create revenue. |
| `result.data.orgs[].businessModels[].businessModel` | `string` | No | — | The name of the business model. |
| `result.data.orgs[].businessModels[].businessModelId` | `integer` | No | — | The CBI ID of the business model; see [https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/business-models](https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/business-models) |
| `result.data.orgs[].childOrgs` | `array` | No | — | Information about this organization's subsidiaries. |
| `result.data.orgs[].childOrgs[].name` | `string` | No | — | The name of the organization. |
| `result.data.orgs[].childOrgs[].orgId` | `integer` | No | — | CB Insights organization ID. |
| `result.data.orgs[].competitors` | `array` | No | — | Competitors that CB Insights has determined are related to the company. |
| `result.data.orgs[].competitors[].name` | `string` | No | — | The name of the organization. |
| `result.data.orgs[].competitors[].orgId` | `integer` | No | — | CB Insights organization ID. |
| `result.data.orgs[].competitors[].score` | `number` | No | — | The Competitor Score of this competitor. |
| `result.data.orgs[].expertCollections` | `array` | No | — | CB Insights analyst-curated lists of companies that this company is a part of. |
| `result.data.orgs[].expertCollections[].collectionId` | `integer` | No | — | The ID of the Expert Collection. |
| `result.data.orgs[].expertCollections[].collectionName` | `string` | No | — | Name of the Expert Collection. |
| `result.data.orgs[].financials` | `object` | No | — | — |
| `result.data.orgs[].financials.lastFundingDate` | `string` | No | — | The date of the most recent funding round, in the format YYYY-MM-DD. |
| `result.data.orgs[].financials.latestRevenueMultipleMax` | `number` | No | — | The latest maximum known revenue multiple. |
| `result.data.orgs[].financials.latestRevenueMultipleMin` | `number` | No | — | The latest minimum known revenue multiple. |
| `result.data.orgs[].financials.marketCap` | `number` | No | — | For public companies, the market capitalization of the organization in millions of US dollars. |
| `result.data.orgs[].financials.revenueDate` | `string` | No | — | The date of the most recent revenue data, in the format YYYY-MM-DD. |
| `result.data.orgs[].financials.revenueMax` | `number` | No | — | The latest maximum known revenue in US dollars. |
| `result.data.orgs[].financials.revenueMin` | `number` | No | — | The latest minimum known revenue in US dollars. For most organizations, revenueMin is equal to revenueMax. |
| `result.data.orgs[].financials.revenuePeriod` | `string` | No | — | The fiscal period that the latest revenue data covers. For public companies, revenue is reported for the last known full fiscal year. |
| `result.data.orgs[].financials.stockLastClose` | `number` | No | — | For public companies, the price, in US dollars, at which it traded at the end of the previous regular trading session. |
| `result.data.orgs[].financials.totalEquityFunding` | `number` | No | — | Total equity funding, in millions of US dollars. This only includes rounds where equity is exchanged. |
| `result.data.orgs[].financials.totalFunding` | `number` | No | — | Total funding of any type raised by this organization, in millions of US dollars. This includes Grant, Accelerator, Debt, and other non-equity rounds. |
| `result.data.orgs[].financials.valuation` | `number` | No | — | Latest valuation on record in millions of US dollars. |
| `result.data.orgs[].headcount` | `object` | No | — | — |
| `result.data.orgs[].headcount.currentHeadcount` | `integer` | No | — | The current headcount of this organization. |
| `result.data.orgs[].headcount.oneYearGrowth` | `number` | No | — | The change in this organization's headcount over the past 12 months, expressed as a decimal offset from zero (i.e. a 12.3% increase returns 0.123, and a 45.6% decrease returns -0.456). |
| `result.data.orgs[].headcount.sixMonthGrowth` | `number` | No | — | The change in this organization's headcount over the past 6 months, expressed as a decimal offset from zero (i.e. a 12.3% increase returns 0.123, and a 45.6% decrease returns -0.456). |
| `result.data.orgs[].headcount.twoYearGrowth` | `number` | No | — | The change in this organization's headcount over the past 24 months, expressed as a decimal offset from zero (i.e. a 12.3% increase returns 0.123, and a 45.6% decrease returns -0.456). |
| `result.data.orgs[].identifiers` | `object` | No | — | — |
| `result.data.orgs[].identifiers.ciks` | `array` | No | — | SEC Central Index Keys. |
| `result.data.orgs[].identifiers.cusips` | `array` | No | — | Committee on Uniform Security Identification Procedures (North American security identifiers). |
| `result.data.orgs[].identifiers.figis` | `array` | No | — | Financial Instrument Global Identifiers (also known as OpenFIGI). |
| `result.data.orgs[].identifiers.isins` | `array` | No | — | International Securities Identification Numbers. |
| `result.data.orgs[].identifiers.leis` | `array` | No | — | Legal Entity Identifiers. |
| `result.data.orgs[].identifiers.tickers` | `array` | No | — | Stock tickers associated with this organization, not including the exchange associated with each ticker. |
| `result.data.orgs[].identifiers.tickersWithExchanges` | `array` | No | — | Stock tickers associated with this organization, including the exchange of each ticker, separated by a colon. |
| `result.data.orgs[].orgId` | `integer` | No | — | CB Insights organization ID. |
| `result.data.orgs[].parentOrgs` | `array` | No | — | Information about parent organization(s). |
| `result.data.orgs[].parentOrgs[].name` | `string` | No | — | The name of the organization. |
| `result.data.orgs[].parentOrgs[].orgId` | `integer` | No | — | CB Insights organization ID. |
| `result.data.orgs[].summary` | `object` | No | — | — |
| `result.data.orgs[].summary.additionalUrls` | `array` | No | — | Any additional websites the organization may have. |
| `result.data.orgs[].summary.address` | `object` | No | — | — |
| `result.data.orgs[].summary.address.city` | `string` | No | — | The name of the city in which the organization is located. |

The table shows the first 50 fields. Use the live contract below for every field.

<Info>
  This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get cbinsights_post_v2_firmographics --json`.
</Info>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [CB Insights provider guide](/docs/providers/cbinsights/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.