Dealroom.co: Dealroom Get Investor By ID

Get an investor’s profile from its investor ID.

Tool ID: dealroom_get_investor_by_id

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'dealroom_get_investor_by_id',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute dealroom_get_investor_by_id --input '{
  "id": "id_123"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "investor_type": "example",
    "id": 123,
    "name": "Example"
  }
}

Use deepline describe dealroom_get_investor_by_id --json for the latest machine-readable contract.

Input reference

The Get investor by ID endpoint allows you to retrieve data on a specific investor, using the Dealroom ID number. The endpoint uses the GET request method. The response provides a set of default fields for the specified investor, unless fields are added in the request. To retrieve multiple IDs at once, please refer to the Batch endpoint. Disclaimer: The fundings, investment, team and funds_under_management data fields are limited to 5 results per investor. This limit is in place for performance reasons. To get the full number of results, please use the respective Funding rounds, Investments, 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 investor. The ID can be one of two types of inputs: * Integer: the number ID of the investor (e.g. 2388) * String : the path of the investor (e.g. index_ventures)
`payload.fields`	`string`	No	—	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: `All fields are available by default` * All Fields: ``` See the live schema for the complete constraint.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.investor_type`	`string`	No	—	The type or category of the investor. Examples include accelerator, advisor, angel, corporate, crowdfunding, etc.
`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.sub_types`	`array`	No	—	Sub-types or categories of the investor.
`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.investment_stages`	`"seed" \| "early growth" \| "late growth" \| "mature" \| "not meaningful"`	No	—	Focus of growth stages for investments Allowed: `seed`, `early growth`, `late growth`, `mature`, `not meaningful`.
`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.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`.
`result.data.hq_locations[].country.lon`	`number \| null`	No	—	Country longitude Format: `float`.
`result.data.hq_locations[].state`	`object \| null`	No	—	HQ location state
`result.data.hq_locations[].state.id`	`integer`	No	—	State ID
`result.data.hq_locations[].state.name`	`string`	No	—	State name
`result.data.hq_locations[].state.slug`	`string \| null`	No	—	URL-friendly identifier for the state
`result.data.hq_locations[].state.lat`	`number \| null`	No	—	State latitude Format: `float`.

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

This output schema is too large for an inline display. Read the complete live contract with deepline describe dealroom_get_investor_by_id --json.

Deepline cost

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

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation