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

# Dealroom.co: Dealroom Get Company By ID

> Get company by ID. Dealroom.co Dealroom Get Company By Id reference includes SDK V2 and CLI requests, input constraints, response fields, and Deepline cost.

Get company by ID.

<Info>
  Tool ID: `dealroom_get_company_by_id`
</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(
  'dealroom_get_company_by_id',
  {
    "id": "id_123"
  },
);

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

### CLI

```bash theme={null}
deepline tools execute dealroom_get_company_by_id --input '{
  "id": "id_123"
}' --json
```

## Example response

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

```json theme={null}
{
  "data": {
    "type": "example",
    "id": 123,
    "name": "Example"
  }
}
```

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

## Input reference

The `Get company by ID` endpoint allows you to retrieve data on a specific company, using the Dealroom ID number. The endpoint uses the GET method for requests. The response provides all the available fields for the company endpoint, for a specific company, unless only specific fields are added in the request. To retrieve multiple IDs at once, please refer to the [Batch endpoint](https://docs.dealroom.co/docs/premium-api/operations/companyBatch). Disclaimer: The `funding`, `investor` and `team` data fields are limited to 5 results per company. This limit is in place for performance reasons. To get the full number of results, please use the respective [Funding rounds](https://docs.dealroom.co/docs/premium-api/operations/companyFundings), [Investors](https://docs.dealroom.co/docs/premium-api/operations/companyInvestors) or See the live schema below for the complete notes.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string \| integer` | Yes | — | The ID key used to retrieve the company. The ID can be one of two types of inputs: \* Integer: the number ID of the company (e.g. 137776) \* String : the path of the company (e.g. Cohesity) |
| `payload.fields` | `string` | No | `"id,name,path,images(32x32,74x74,100x100),tagline,hq_locations,growth_stage,employees,total_funding,last_updated"` | Allows you to select which fields the response should return. All available fields are specified below(by data type) and in the response sample to the right. The fields should be input as a comma-separated string . Nested fields are supported using the brackets notation. \* Default Fields: `id,name,path,images(32x32,74x74,100x100),tagline,hq_locations,growth_stage,employees,total_funding,last_updated` \* All Fields: \`\`\` See the live schema for the complete constraint. |

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

  ### Input JSON Schema

  ````json theme={null}
  {
    "type": "object",
    "description": "The `Get company by ID` endpoint allows you to retrieve data on a specific company, using the Dealroom ID number. The endpoint uses the GET method for requests. The response provides all the available fields for the company endpoint, for a specific company, unless only specific fields are added in the request. To retrieve multiple IDs at once, please refer to the [Batch endpoint](https://docs.dealroom.co/docs/premium-api/operations/companyBatch). Disclaimer: The `funding`, `investor` and `team` data fields are limited to 5 results per company. This limit is in place for performance reasons. To get the full number of results, please use the respective [Funding rounds](https://docs.dealroom.co/docs/premium-api/operations/companyFundings), [Investors](https://docs.dealroom.co/docs/premium-api/operations/companyInvestors) or [Team](https://docs.dealroom.co/docs/premium-api/operations/companyTeam) endpoints.",
    "properties": {
      "id": {
        "description": "The ID key used to retrieve the company. The ID can be one of two types of inputs: * Integer: the number ID of the company (e.g. 137776) * String : the path of the company (e.g. Cohesity)",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "integer"
          }
        ]
      },
      "fields": {
        "type": "string",
        "description": "Allows you to select which fields the response should return. All available fields are specified below(by data type) and in the response sample to the right. The fields should be input as a comma-separated string . Nested fields are supported using the brackets notation. * Default Fields: ``` id,name,path,images(32x32,74x74,100x100),tagline,hq_locations,growth_stage,employees,total_funding,last_updated ``` * All Fields: ``` type,id,name,deleted,path,tagline,about,about_ai_generated,url,website_url,twitter_url,facebook_url,linkedin_url,google_url,playmarket_app_id,appstore_app_id,images,employees,employees_latest,industries,sub_industries,service_industries,technologies,income_streams,growth_stage,hq_locations,legal_entities,client_focus,revenues,tags,ownerships,launch_year,launch_month,closing_year,closing_month,has_promising_founder,has_strong_founder,has_super_founder,total_funding,total_funding_currency,total_funding_source,last_funding,last_funding_source,company_status,last_updated,last_updated_utc,last_funding_date,created_utc,facebook_likes_chart,twitter_tweets_chart,twitter_followers_chart,twitter_favorites_chart,employees_chart,website_traffic_3_months_growth_unique,website_traffic_3_months_growth_percentile,website_traffic_3_months_growth_relative,website_traffic_3_months_growth_delta,website_traffic_6_months_growth_unique,website_traffic_6_months_growth_percentile,website_traffic_6_months_growth_relative,website_traffic_6_months_growth_delta,website_traffic_12_months_growth_unique,website_traffic_12_months_growth_percentile,website_traffic_12_months_growth_relative,website_traffic_12_months_growth_delta,app_3_months_growth_unique,app_3_months_growth_percentile,app_3_months_growth_relative,app_6_months_growth_unique,app_6_months_growth_percentile,app_6_months_growth_relative,app_12_months_growth_unique,app_12_months_growth_percentile,app_12_months_growth_relative,employee_3_months_growth_unique,employee_3_months_growth_percentile,employee_3_months_growth_relative,employee_3_months_growth_delta,employee_6_months_growth_unique,employee_6_months_growth_percentile,employee_6_months_growth_relative,employee_6_months_growth_delta,employee_12_months_growth_unique,employee_12_months_growth_percentile,employee_12_months_growth_relative,employee_12_months_growth_delta,innovation_corporate_rank,kpi_summary,team,investors,fundings,limited_partner_investments,known_limited_partners,website_traffic_estimates_chart,job_openings,app_downloads_ios_chart,app_downloads_android_chart,app_downloads_ios_incremental_chart,app_downloads_android_incremental_chart,tech_stack_predictleads,sustainable_development_goals,core_side_value,data_type,pic_number,patents_count,dealroom_signal,business_emails ```",
        "default": "id,name,path,images(32x32,74x74,100x100),tagline,hq_locations,growth_stage,employees,total_funding,last_updated"
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  }
  ````
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.type` | `string` | No | — | The type or category of the entity. |
| `result.data.id` | `integer` | No | — | Unique Dealroom identifier for the entity profile |
| `result.data.name` | `string` | No | — | Entity name |
| `result.data.deleted` | `boolean` | No | — | If true, this entity was already removed from Dealroom DB (deletion not yet fully propagated) |
| `result.data.path` | `string \| null` | No | — | Url path at dealroom.co |
| `result.data.tagline` | `string \| null` | No | — | Short description of the entity |
| `result.data.about` | `string \| null` | No | — | Description or summary of the entity |
| `result.data.about_ai_generated` | `boolean` | No | — | — |
| `result.data.url` | `string` | No | — | Url at dealroom.co |
| `result.data.website_url` | `string \| null` | No | — | Website of the entity |
| `result.data.twitter_url` | `string \| null` | No | — | URL of the entity's Twitter profile |
| `result.data.facebook_url` | `string \| null` | No | — | URL of the entity's Facebook profile |
| `result.data.linkedin_url` | `string \| null` | No | — | URL of the entity's LinkedIn profile |
| `result.data.google_url` | `string \| null` | No | — | URL of the entity's Google plus profile |
| `result.data.playmarket_app_id` | `string \| null` | No | — | The ID of the entity's mobile app in the Apple App Store |
| `result.data.appstore_app_id` | `string \| null` | No | — | The ID of the entity's mobile app in the Google Play Store |
| `result.data.images` | `object` | No | — | — |
| `result.data.images.32x32` | `string` | No | — | Image of size 32x32 px |
| `result.data.images.74x74` | `string` | No | — | Image of size 74x74 px |
| `result.data.images.100x100` | `string` | No | — | Image of size 100x100 px |
| `result.data.employees` | `"1" \| "2-10" \| "11-50" \| "51-200" \| "201-500" \| "501-1000" \| "1001-5000" \| "5001-10000" \| "10001+"` | No | — | Range of employees: 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ Allowed: `1`, `2-10`, `11-50`, `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001-10000`, `10001+`. |
| `result.data.employees_latest` | `integer \| null` | No | — | Latest employees exact value |
| `result.data.industries` | `array` | No | — | Industries the company operates in/is related to |
| `result.data.industries[].id` | `integer` | No | — | Param ID |
| `result.data.industries[].name` | `string` | No | — | Param name |
| `result.data.sub_industries` | `array` | No | — | Sub industries the startup operates in/is related to |
| `result.data.service_industries` | `array` | No | — | Industries associated with the entity's services |
| `result.data.technologies` | `array` | No | — | The technologies used by entity to operate their business |
| `result.data.income_streams` | `array` | No | — | The income streams used by entity to operate their business |
| `result.data.growth_stage` | `"seed stage" \| "early stage" \| "late stage" \| "mature" \| "not meaningful" \| "breakout stage"` | No | — | Entity growth stage Allowed: `seed stage`, `early stage`, `late stage`, `mature`, `not meaningful`, `breakout stage`. |
| `result.data.hq_locations` | `array` | No | — | Locations of the entity's headquarters |
| `result.data.hq_locations[].id` | `integer` | No | — | HQ location ID |
| `result.data.hq_locations[].is_headquarters` | `boolean` | No | — | Is headquarters |
| `result.data.hq_locations[].is_founding_location` | `boolean` | No | — | Is founding location |
| `result.data.hq_locations[].address` | `string \| null` | No | — | HQ location address |
| `result.data.hq_locations[].street` | `string \| null` | No | — | HQ location street |
| `result.data.hq_locations[].street_number` | `string \| null` | No | — | HQ location street number |
| `result.data.hq_locations[].zip` | `string \| null` | No | — | HQ location zip code |
| `result.data.hq_locations[].lat` | `number \| null` | No | — | HQ location latitude Format: `float`. |
| `result.data.hq_locations[].lon` | `number \| null` | No | — | HQ location longitude Format: `float`. |
| `result.data.hq_locations[].continent` | `object \| null` | No | — | HQ location continent |
| `result.data.hq_locations[].continent.id` | `integer` | No | — | Continent ID |
| `result.data.hq_locations[].continent.name` | `string` | No | — | URL-friendly identifier for the continent |
| `result.data.hq_locations[].continent.slug` | `string \| null` | No | — | Slug |
| `result.data.hq_locations[].country` | `object \| null` | No | — | HQ location country |
| `result.data.hq_locations[].country.id` | `integer` | No | — | Country ID |
| `result.data.hq_locations[].country.name` | `string` | No | — | Country name |
| `result.data.hq_locations[].country.slug` | `string \| null` | No | — | URL-friendly identifier for the country |
| `result.data.hq_locations[].country.lat` | `number \| null` | No | — | Country latitude Format: `float`. |

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 dealroom_get_company_by_id --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

* [Dealroom.co provider guide](/docs/providers/dealroom/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.