> ## 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.
# Fundable: Discover Companies
> Discover companies with metadata and full latest-deal details. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.
Discover companies with metadata and full latest-deal details.
Tool ID: `fundable_discover_companies`
## 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(
'fundable_discover_companies',
{
"identifiers": {
"ids": [
"123e4567-e89b-42d3-a456-426614174000"
],
"domains": [
"example.com"
],
"linkedin_urls": [
"https://www.linkedin.com/in/jane-doe"
]
},
"company": {
"search_query": "software companies hiring engineers",
"min_relevance": 1,
"locations": [
"example"
]
},
"latest_deal": {
"financing_types": [
{
"type": "SERIES_A"
}
],
"size_min": 123,
"size_max": 123
}
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute fundable_discover_companies --input '{
"identifiers": {
"ids": [
"123e4567-e89b-42d3-a456-426614174000"
],
"domains": [
"example.com"
],
"linkedin_urls": [
"https://www.linkedin.com/in/jane-doe"
]
},
"company": {
"search_query": "software companies hiring engineers",
"min_relevance": 1,
"locations": [
"example"
]
},
"latest_deal": {
"financing_types": [
{
"type": "SERIES_A"
}
],
"size_min": 123,
"size_max": 123
}
}' --json
```
## Example response
The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.
```json theme={null}
{
"data": {
"success": true,
"data": {
"companies": [
{
"id": "123e4567-e89b-42d3-a456-426614174000",
"name": "Example",
"legal_name": "Example"
}
]
},
"meta": {
"total_count": 123,
"page": 123,
"page_size": 123
}
}
}
```
Use `deepline tools get fundable_discover_companies --json` for the latest machine-readable contract.
## Input reference
Use this endpoint by default for company sourcing and discovery. It returns company metadata such as name and domain together with the full details of each company's latest funding round. Filters inside `latest_deal` apply only to the company's most recent round. Use `POST /deals` instead when deal criteria must match any round in a company's history. For example, `/companies` is appropriate for "find AI companies in San Francisco whose latest round was Seed"; `/deals` is appropriate for "analyze all Seed rounds announced last year," regardless of whether Seed is now the company's latest round. Filters inside `investors` can match investor participation across all rounds. ## Request Body Structure Send a JSON body with up to 4 filter sections plus pagination/sort at the top level: - `identifiers` - Look up specific companies by UUID, domain, LinkedIn, or Crunchbase - `company` - Filter See the live schema below for the complete notes.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.identifiers` | `object` | No | — | Look up specific companies by identifier |
| `payload.company` | `object` | No | — | Company attribute filters |
| `payload.latest_deal` | `object` | No | — | Latest funding round filters |
| `payload.investors` | `object` | No | — | Filter by investors (firms or people) across all funding rounds |
| `payload.page` | `integer` | No | `0` | Page number (0-based) Minimum: 0. |
| `payload.page_size` | `integer` | No | `10` | Number of results per page Minimum: 1. Maximum: 500. |
| `payload.sort_by` | `"most_recent_raise" \| "oldest_raise" \| "most_recent_founded" \| "oldest_founded" \| "largest_valuation" \| "smallest_valuation" \| "largest_total_raise" \| "smallest_total_raise" \| "most_funding_rounds" \| "most_investors"` | No | `"most_recent_raise"` | Sort order. Ignored when search\_query is provided (sorted by relevance). Allowed: `most_recent_raise`, `oldest_raise`, `most_recent_founded`, `oldest_founded`, `largest_valuation`, `smallest_valuation`, `largest_total_raise`, `smallest_total_raise`, `most_funding_rounds`, `most_investors`. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Use this endpoint by default for company sourcing and discovery. It returns company metadata such as name and domain together with the full details of each company's latest funding round. Filters inside `latest_deal` apply only to the company's most recent round. Use `POST /deals` instead when deal criteria must match any round in a company's history. For example, `/companies` is appropriate for \"find AI companies in San Francisco whose latest round was Seed\"; `/deals` is appropriate for \"analyze all Seed rounds announced last year,\" regardless of whether Seed is now the company's latest round. Filters inside `investors` can match investor participation across all rounds. ## Request Body Structure Send a JSON body with up to 4 filter sections plus pagination/sort at the top level: - `identifiers` - Look up specific companies by UUID, domain, LinkedIn, or Crunchbase - `company` - Filter by company attributes (search, location, industry, size, etc.) - `latest_deal` - Filter by latest funding round attributes (type, size, date, investors) - `investors` - Filter by investors (firms or people) across all rounds",
"properties": {
"identifiers": {
"type": "object",
"description": "Look up specific companies by identifier",
"properties": {
"ids": {
"type": "array",
"description": "Company UUIDs",
"items": {
"type": "string",
"format": "uuid"
}
},
"domains": {
"type": "array",
"description": "Company domains (max 100)",
"items": {
"type": "string"
}
},
"linkedin_urls": {
"type": "array",
"description": "LinkedIn company URLs (max 100)",
"items": {
"type": "string"
}
},
"crunchbase_urls": {
"type": "array",
"description": "Crunchbase organization URLs (max 100)",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"company": {
"type": "object",
"description": "Company attribute filters",
"properties": {
"search_query": {
"type": "string",
"description": "AI-powered semantic search — a flexible replacement for an industry tag. First use /industry/search and apply an `industries` or `super_categories` filter when the taxonomy contains the intended category. Use semantic search only for a niche industry or specific product type the taxonomy cannot express, describing what the company does — its product, technology, or business model (e.g. \"AI-powered medical imaging diagnostics\" or \"vertical SaaS for dental practices\"). Do NOT use it for other attributes like stage, location, funding, or employee count — apply those with the dedicated filter fields instead. Results include a similarity score, are sorted by relevance, and are capped at 150 semantic matches."
},
"min_relevance": {
"type": "number",
"description": "Minimum similarity threshold (0-1). Only applies with search_query.",
"minimum": 0,
"maximum": 1
},
"locations": {
"type": "array",
"description": "Location permalinks. Use /location/search to find permalinks. A value that is not an exact permalink is silently ignored (returns zero results, no error).",
"items": {
"type": "string"
}
},
"industries": {
"type": "array",
"description": "Industry permalinks. Use /industry/search to find permalinks. A value that is not an exact permalink is silently ignored (returns zero results, no error).",
"items": {
"type": "string"
}
},
"super_categories": {
"type": "array",
"description": "Super category permalinks (automatically includes related industries). Use /industry/search to find permalinks. A value that is not an exact permalink is silently ignored (returns zero results, no error).",
"items": {
"type": "string"
}
},
"employee_count": {
"type": "array",
"description": "Employee count ranges. Valid: 1-10, 11-50, 51-100, 101-250, 251-500, 501-1000, 1001-5000, 5001-10000, 10001+",
"items": {
"type": "string",
"enum": [
"1-10",
"11-50",
"51-100",
"101-250",
"251-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001+"
]
}
},
"ipo_status": {
"type": "array",
"description": "IPO status filter. Valid: public, private",
"items": {
"type": "string",
"enum": [
"public",
"private"
]
}
},
"total_raised_min": {
"type": "number",
"description": "Minimum total raised (USD)",
"minimum": 0
},
"total_raised_max": {
"type": "number",
"description": "Maximum total raised (USD)",
"minimum": 0
}
},
"additionalProperties": false
},
"latest_deal": {
"type": "object",
"description": "Latest funding round filters",
"properties": {
"financing_types": {
"type": "array",
"description": "Financing types with optional modifiers (pre, extension)",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"SERIES_A",
"SERIES_B",
"SERIES_C",
"SERIES_D",
"SERIES_E",
"SERIES_F",
"SERIES_G",
"SERIES_H",
"SERIES_I",
"SERIES_J",
"SERIES_K",
"SERIES_L",
"SERIES_M",
"SEED",
"SAFE",
"CONVERTIBLE_NOTE",
"EQUITY",
"PREFERRED",
"SECONDARY_MARKET",
"DEBT_FINANCING",
"GRANT",
"NON_EQUITY_ASSISTANCE",
"CROWDFUNDING",
"INITIAL_COIN_OFFERING",
"FUNDING_ROUND"
]
},
"pre": {
"type": "boolean",
"description": "Pre-round modifier (e.g., Pre-Seed, Pre-Series A)",
"default": false
},
"extension": {
"type": "boolean",
"description": "Extension round modifier",
"default": false
}
},
"required": [
"type"
],
"additionalProperties": false
}
},
"size_min": {
"type": "number",
"description": "Minimum deal size (USD)",
"minimum": 0
},
"size_max": {
"type": "number",
"description": "Maximum deal size (USD)",
"minimum": 0
},
"date_start": {
"type": "string",
"description": "Latest deal after this date (ISO 8601)",
"format": "date"
},
"date_end": {
"type": "string",
"description": "Latest deal before this date (ISO 8601)",
"format": "date"
},
"created_start": {
"type": "string",
"description": "Latest deal record added to the system on or after this date (ISO 8601). Filters by ingestion date (`created_at`), not the announcement date — useful for finding rounds newly added to Fundable.",
"format": "date"
},
"created_end": {
"type": "string",
"description": "Latest deal record added to the system on or before this date (ISO 8601). Filters by ingestion date (`created_at`), not the announcement date.",
"format": "date"
},
"investor_ids": {
"type": "array",
"description": "Filter by investors who participated in the latest deal only",
"items": {
"type": "string",
"format": "uuid"
}
}
},
"additionalProperties": false
},
"investors": {
"type": "object",
"description": "Filter by investors (firms or people) across all funding rounds",
"properties": {
"investor_ids": {
"type": "array",
"description": "Investor UUIDs — matches companies where these investors participated in any round ever",
"items": {
"type": "string",
"format": "uuid"
}
},
"people_ids": {
"type": "array",
"description": "Person UUIDs — matches companies where any of these people participated in any round as an **angel investor** OR as a **lead partner** of an investing firm. Resolve via `/people/{id}`.",
"items": {
"type": "string",
"format": "uuid"
}
}
},
"additionalProperties": false
},
"page": {
"type": "integer",
"description": "Page number (0-based)",
"default": 0,
"minimum": 0
},
"page_size": {
"type": "integer",
"description": "Number of results per page",
"default": 10,
"minimum": 1,
"maximum": 500
},
"sort_by": {
"type": "string",
"description": "Sort order. Ignored when search_query is provided (sorted by relevance).",
"default": "most_recent_raise",
"enum": [
"most_recent_raise",
"oldest_raise",
"most_recent_founded",
"oldest_founded",
"largest_valuation",
"smallest_valuation",
"largest_total_raise",
"smallest_total_raise",
"most_funding_rounds",
"most_investors"
]
}
},
"required": [],
"additionalProperties": false
}
```
## Output reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.success` | `boolean` | Yes | — | — |
| `result.data.data` | `object` | Yes | — | — |
| `result.data.data.companies` | `array` | No | — | — |
| `result.data.data.companies[].id` | `string` | No | — | Unique identifier for the company Format: `uuid`. |
| `result.data.data.companies[].name` | `string \| null` | No | — | Company name |
| `result.data.data.companies[].legal_name` | `string \| null` | No | — | Legal name of the company |
| `result.data.data.companies[].guru_permalink` | `string \| null` | No | — | Fundable permalink for the company |
| `result.data.data.companies[].domain` | `string \| null` | No | — | Company website domain |
| `result.data.data.companies[].region` | `string \| null` | No | — | Company region |
| `result.data.data.companies[].operating_status` | `string \| null` | No | — | Current operating status of the company |
| `result.data.data.companies[].founded_date` | `string \| null` | No | — | Date and time the company was founded Format: `date-time`. |
| `result.data.data.companies[].acquired` | `boolean \| null` | No | — | Whether the company has been acquired |
| `result.data.data.companies[].short_description` | `string \| null` | No | — | Brief description of the company |
| `result.data.data.companies[].long_description` | `string \| null` | No | — | Full description of the company. Available on /company endpoint; may be null on /companies list endpoint. |
| `result.data.data.companies[].num_employees` | `string \| null` | No | — | Number of employees range |
| `result.data.data.companies[].linkedin` | `string \| null` | No | — | LinkedIn profile URL Format: `uri`. |
| `result.data.data.companies[].twitter` | `string \| null` | No | — | Twitter profile URL Format: `uri`. |
| `result.data.data.companies[].facebook` | `string \| null` | No | — | Facebook profile URL Format: `uri`. |
| `result.data.data.companies[].pitchbook` | `string \| null` | No | — | PitchBook profile URL Format: `uri`. |
| `result.data.data.companies[].crunchbase` | `string \| null` | No | — | Crunchbase profile URL Format: `uri`. |
| `result.data.data.companies[].address` | `string \| null` | No | — | Company address |
| `result.data.data.companies[].ipo_status` | `"public" \| "private"` | No | — | IPO status of the company Allowed: `public`, `private`. |
| `result.data.data.companies[].num_funding_rounds` | `integer \| null` | No | — | Number of funding rounds |
| `result.data.data.companies[].num_investors` | `integer \| null` | No | — | Number of investors |
| `result.data.data.companies[].total_raised` | `number \| null` | No | — | Total amount raised (USD) |
| `result.data.data.companies[].latest_valuation_usd` | `number \| null` | No | — | Latest valuation (USD) |
| `result.data.data.companies[].latest_valuation_date` | `string \| null` | No | — | Date of latest valuation Format: `date-time`. |
| `result.data.data.companies[].industries` | `array` | No | — | Industries the company operates in |
| `result.data.data.companies[].industries[].permalink` | `string` | No | — | Industry permalink |
| `result.data.data.companies[].industries[].name` | `string` | No | — | Industry name |
| `result.data.data.companies[].location` | `object` | No | — | Company location hierarchy |
| `result.data.data.companies[].location.region` | `object \| null` | No | — | — |
| `result.data.data.companies[].location.region.name` | `string` | No | — | Region name |
| `result.data.data.companies[].location.region.permalink` | `string` | No | — | Region permalink |
| `result.data.data.companies[].location.country` | `object \| null` | No | — | — |
| `result.data.data.companies[].location.country.name` | `string` | No | — | Country name |
| `result.data.data.companies[].location.country.permalink` | `string` | No | — | Country permalink |
| `result.data.data.companies[].location.state` | `object \| null` | No | — | — |
| `result.data.data.companies[].location.state.name` | `string` | No | — | State name |
| `result.data.data.companies[].location.state.permalink` | `string` | No | — | State permalink |
| `result.data.data.companies[].location.city` | `object \| null` | No | — | — |
| `result.data.data.companies[].location.city.name` | `string` | No | — | City name |
| `result.data.data.companies[].location.city.permalink` | `string` | No | — | City permalink |
| `result.data.data.companies[].latest_deal` | `object \| null` | No | — | Details of the company's most recent funding round |
| `result.data.data.companies[].latest_deal.id` | `string \| null` | Yes | — | Unique identifier for the deal Format: `uuid`. |
| `result.data.data.companies[].latest_deal.type` | `"SERIES_A" \| "SERIES_B" \| "SERIES_C" \| "SERIES_D" \| "SERIES_E" \| "SERIES_F" \| "SERIES_G" \| "SERIES_H" \| "SERIES_I" \| "SERIES_J" \| "SERIES_K" \| "SERIES_M" \| "SEED" \| "SAFE" \| "CONVERTIBLE_NOTE" \| "EQUITY" \| "PREFERRED" \| "SECONDARY_MARKET" \| "DEBT_FINANCING" \| "GRANT" \| "NON_EQUITY_ASSISTANCE" \| "CROWDFUNDING" \| "INITIAL_COIN_OFFERING" \| "FUNDING_ROUND" \| "HYBRID" \| "HYBRID_SEED" \| "HYBRID_SERIES_A" \| "HYBRID_SERIES_B" \| "HYBRID_SERIES_C" \| "HYBRID_SERIES_D" \| "HYBRID_SERIES_E" \| "HYBRID_SERIES_F" \| "HYBRID_SERIES_G" \| "HYBRID_SERIES_H" \| "HYBRID_SERIES_I" \| "HYBRID_SERIES_J" \| "HYBRID_SERIES_K" \| "HYBRID_SERIES_M"` | Yes | — | Type of funding round Allowed: `SERIES_A`, `SERIES_B`, `SERIES_C`, `SERIES_D`, `SERIES_E`, `SERIES_F`, `SERIES_G`, `SERIES_H`, `SERIES_I`, `SERIES_J`, `SERIES_K`, `SERIES_M`, `SEED`, `SAFE`, `CONVERTIBLE_NOTE`, `EQUITY`, `PREFERRED`, `SECONDARY_MARKET`, `DEBT_FINANCING`, `GRANT`, `NON_EQUITY_ASSISTANCE`, `CROWDFUNDING`, `INITIAL_COIN_OFFERING`, `FUNDING_ROUND`, `HYBRID`, `HYBRID_SEED`, `HYBRID_SERIES_A`, `HYBRID_SERIES_B`, `HYBRID_SERIES_C`, `HYBRID_SERIES_D`, `HYBRID_SERIES_E`, See the live schema for the complete constraint. |
| `result.data.data.companies[].latest_deal.total_round_raised` | `number \| null` | Yes | — | Total amount raised in the round (USD) |
| `result.data.data.companies[].latest_deal.date` | `string \| null` | Yes | — | Date of the funding round Format: `date-time`. |
| `result.data.data.companies[].latest_deal.extension` | `boolean \| null` | Yes | — | Whether this is an extension round |
The table shows the first 50 fields. Expand the raw schema below for every field.
This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get fundable_discover_companies --json`.
## Deepline cost
* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.7` per pricing unit.
## Related documentation
* [Fundable provider guide](/docs/providers/fundable/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.