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

> Look up CB Insights organization IDs by name, URL, or profile URL. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Look up CB Insights organization IDs by name, URL, or profile URL.

<Info>
  Tool ID: `cbinsights_post_v2_organizations`
</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_organizations',
  {
    "names": [
      "Example"
    ]
  },
);

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

### CLI

```bash theme={null}
deepline tools execute cbinsights_post_v2_organizations --input '{
  "names": [
    "Example"
  ]
}' --json
```

## Example response

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

```json theme={null}
{
  "data": {
    "nextPageToken": "example",
    "orgs": [
      {
        "aliases": [
          "example"
        ],
        "description": "Example description",
        "name": "Example"
      }
    ],
    "totalHits": 123
  }
}
```

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

## Input reference

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

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.limit` | `integer` | No | — | The maximum number of organizations to be returned in a single response. Must be in the range \[1, 100]. Defaults to 10. |
| `payload.names` | `array` | No | — | Names to look up. Minimum items: 1. |
| `payload.nextPageToken` | `string` | No | — | Token to fetch the next page of results; provided in a previous response. |
| `payload.profileUrl` | `string` | No | — | Returns the corresponding organization profile. Note: This is mutually exclusive with the names and urls fields; an error will be returned if there are values for profileUrl and names or urls. Minimum length: 1. |
| `payload.sort` | `object` | No | — | The order in which the results will be returned. |
| `payload.urls` | `array` | No | — | URLs to look up. Minimum items: 1. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Search parameters to lookup a list of organization profiles. You must pass at least one search parameter.",
    "properties": {
      "limit": {
        "type": "integer",
        "description": "The maximum number of organizations to be returned in a single response. Must be in the range [1, 100]. Defaults to 10."
      },
      "names": {
        "type": "array",
        "description": "Names to look up.",
        "minItems": 1,
        "items": {
          "type": "string",
          "minLength": 1
        }
      },
      "nextPageToken": {
        "type": "string",
        "description": "Token to fetch the next page of results; provided in a previous response."
      },
      "profileUrl": {
        "type": "string",
        "description": "Returns the corresponding organization profile. Note: This is mutually exclusive with the names and urls fields; an error will be returned if there are values for profileUrl and names or urls.",
        "minLength": 1
      },
      "sort": {
        "type": "object",
        "description": "The order in which the results will be returned.",
        "properties": {
          "direction": {
            "type": "string",
            "description": "The order in which the results will be returned. Available sort orders are asc and desc."
          },
          "field": {
            "type": "string",
            "description": "The field to be used to sort returned results. Available sort fields are orgName."
          }
        },
        "additionalProperties": false
      },
      "urls": {
        "type": "array",
        "description": "URLs to look up.",
        "minItems": 1,
        "items": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "required": [],
    "allOf": [
      {},
      {}
    ],
    "anyOf": [
      {
        "required": [
          "names"
        ]
      },
      {
        "required": [
          "urls"
        ]
      },
      {
        "required": [
          "profileUrl"
        ]
      }
    ],
    "additionalProperties": false
  }
  ```
</details>

## 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, includes general information for each organization. |
| `result.data.orgs[].aliases` | `array` | No | — | Aliases of the organization. |
| `result.data.orgs[].description` | `string` | No | — | Description of the organization. |
| `result.data.orgs[].name` | `string` | No | — | Organization name. |
| `result.data.orgs[].orgId` | `integer` | No | — | CB Insights organization ID. |
| `result.data.orgs[].urls` | `array` | No | — | URLs associated with the organization. |
| `result.data.totalHits` | `integer` | No | — | Total number of organizations matching the request parameters. |
| `result.data.totalHitsRelation` | `string` | No | — | Indicates whether totalHits is equal to ('eq'), or greater than or equal to ('gte') the number of organizations which can be fetched. Will be set to 'gte' if totalHits exceeds 10,000. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "nextPageToken": {
            "type": "string",
            "description": "Token to fetch the next page of results. If the value is null, then there are no more results to page through."
          },
          "orgs": {
            "type": "array",
            "description": "A list of organization profiles, includes general information for each organization.",
            "items": {
              "type": "object",
              "properties": {
                "aliases": {
                  "type": "array",
                  "description": "Aliases of the organization.",
                  "items": {
                    "type": "string"
                  }
                },
                "description": {
                  "type": "string",
                  "description": "Description of the organization."
                },
                "name": {
                  "type": "string",
                  "description": "Organization name."
                },
                "orgId": {
                  "type": "integer",
                  "description": "CB Insights organization ID."
                },
                "urls": {
                  "type": "array",
                  "description": "URLs associated with the organization.",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "additionalProperties": false
            }
          },
          "totalHits": {
            "type": "integer",
            "description": "Total number of organizations matching the request parameters."
          },
          "totalHitsRelation": {
            "type": "string",
            "description": "Indicates whether totalHits is equal to ('eq'), or greater than or equal to ('gte') the number of organizations which can be fetched. Will be set to 'gte' if totalHits exceeds 10,000."
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

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