> ## 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: Search Deals
> Find funding rounds across complete company histories. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.
Find funding rounds across complete company histories.
Tool ID: `fundable_search_deals`
## 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_search_deals',
{
"identifiers": {
"deal_ids": [
"123e4567-e89b-42d3-a456-426614174000"
]
},
"deal": {
"financing_types": [
{
"type": "SERIES_A"
}
],
"size_min": 123,
"size_max": 123
},
"company": {
"company_ids": [
"123e4567-e89b-42d3-a456-426614174000"
],
"locations": [
"example"
],
"industries": [
"example"
]
}
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute fundable_search_deals --input '{
"identifiers": {
"deal_ids": [
"123e4567-e89b-42d3-a456-426614174000"
]
},
"deal": {
"financing_types": [
{
"type": "SERIES_A"
}
],
"size_min": 123,
"size_max": 123
},
"company": {
"company_ids": [
"123e4567-e89b-42d3-a456-426614174000"
],
"locations": [
"example"
],
"industries": [
"example"
]
}
}' --json
```
## Example response
The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.
```json theme={null}
{
"data": {
"success": true,
"data": {},
"meta": {
"total_count": 123,
"page": 123,
"page_size": 123
}
}
}
```
Use `deepline tools get fundable_search_deals --json` for the latest machine-readable contract.
## Input reference
Use this endpoint when the requested result is a set of funding rounds, or when deal criteria must match any historical round rather than only each company's latest round. It supports round-level analysis across the full deal history. For most company-sourcing requests, prefer `POST /companies`: it returns company metadata together with the full latest deal. Its `latest_deal` filters apply only to each company's most recent round. For example, use `/companies` for "find AI companies in San Francisco whose latest round was Seed," but use `/deals` for "analyze every Seed round announced last year." Deal records contain full round details, but related companies and investors are identified by IDs instead of full entity profiles. Use `GET /company?id=...` to retrieve company metadata and `GET /deals/{id}/investors` to retrieve the full investor lineup for a returned deal. ## Request Body See the live schema below for the complete notes.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.identifiers` | `object` | No | — | Look up specific deals by identifier |
| `payload.deal` | `object` | No | — | Deal attribute filters |
| `payload.company` | `object` | No | — | Company attribute filters |
| `payload.investors` | `object` | No | — | Filter by investor participation (firms or people) |
| `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_deal" \| "oldest_deal" \| "largest_raise" \| "smallest_raise"` | No | `"most_recent_deal"` | Sort order for results Allowed: `most_recent_deal`, `oldest_deal`, `largest_raise`, `smallest_raise`. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Use this endpoint when the requested result is a set of funding rounds, or when deal criteria must match any historical round rather than only each company's latest round. It supports round-level analysis across the full deal history. For most company-sourcing requests, prefer `POST /companies`: it returns company metadata together with the full latest deal. Its `latest_deal` filters apply only to each company's most recent round. For example, use `/companies` for \"find AI companies in San Francisco whose latest round was Seed,\" but use `/deals` for \"analyze every Seed round announced last year.\" Deal records contain full round details, but related companies and investors are identified by IDs instead of full entity profiles. Use `GET /company?id=...` to retrieve company metadata and `GET /deals/{id}/investors` to retrieve the full investor lineup for a returned deal. ## Request Body Structure Send a JSON body with up to 4 filter sections plus pagination/sort at the top level: - `identifiers` - Look up specific deals by UUID - `deal` - Filter by deal attributes (financing type, size, date) - `company` - Filter by company attributes (location, industry, size) - `investors` - Filter by investor participation (firms or people, by UUID)",
"properties": {
"identifiers": {
"type": "object",
"description": "Look up specific deals by identifier",
"properties": {
"deal_ids": {
"type": "array",
"description": "Deal UUIDs",
"items": {
"type": "string",
"format": "uuid"
}
}
},
"additionalProperties": false
},
"deal": {
"type": "object",
"description": "Deal attribute 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": "Filter deals announced after this date (ISO 8601)",
"format": "date"
},
"date_end": {
"type": "string",
"description": "Filter deals announced before this date (ISO 8601)",
"format": "date"
},
"created_start": {
"type": "string",
"description": "Filter deals added to the system after this date (ISO 8601)",
"format": "date"
},
"created_end": {
"type": "string",
"description": "Filter deals added to the system before this date (ISO 8601)",
"format": "date"
}
},
"additionalProperties": false
},
"company": {
"type": "object",
"description": "Company attribute filters",
"properties": {
"company_ids": {
"type": "array",
"description": "Company UUIDs - filter deals by specific companies",
"items": {
"type": "string",
"format": "uuid"
}
},
"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
},
"investors": {
"type": "object",
"description": "Filter by investor participation (firms or people)",
"properties": {
"investor_ids": {
"type": "array",
"description": "Investor UUIDs (firms)",
"items": {
"type": "string",
"format": "uuid"
}
},
"people_ids": {
"type": "array",
"description": "Person UUIDs — matches deals where any of these people participated 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 for results",
"default": "most_recent_deal",
"enum": [
"most_recent_deal",
"oldest_deal",
"largest_raise",
"smallest_raise"
]
}
},
"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.deals` | `array` | No | — | — |
| `result.data.data.deals[].id` | `string` | Yes | — | Unique identifier for the deal Format: `uuid`. |
| `result.data.data.deals[].round_type` | `"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"` | 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_L`, `SERIES_M`, `SEED`, `SAFE`, `CONVERTIBLE_NOTE`, `EQUITY`, `PREFERRED`, `SECONDARY_MARKET`, `DEBT_FINANCING`, `GRANT`, `NON_EQUITY_ASSISTANCE`, `CROWDFUNDING`, `INITIAL_COIN_OFFERING`, `FUNDING_ROUND`. |
| `result.data.data.deals[].extension` | `boolean \| null` | Yes | — | Whether this is an extension round |
| `result.data.data.deals[].intermediate` | `"PLUS" \| "NONE" \| "ONE" \| "TWO" \| "THREE" \| "FOUR" \| "FIVE" \| "SIX" \| "SEVEN" \| "EIGHT"` | Yes | — | Intermediate round designation Allowed: `PLUS`, `NONE`, `ONE`, `TWO`, `THREE`, `FOUR`, `FIVE`, `SIX`, `SEVEN`, `EIGHT`. |
| `result.data.data.deals[].pre` | `boolean \| null` | Yes | — | Whether this is a pre-round (e.g., Pre-Series A) |
| `result.data.data.deals[].date` | `string \| null` | Yes | — | Announcement date of the funding round Format: `date-time`. |
| `result.data.data.deals[].created_at` | `string \| null` | Yes | — | Date the deal was added to the system Format: `date-time`. |
| `result.data.data.deals[].total_round_raised` | `number \| null` | Yes | — | Total amount raised in the round (USD) |
| `result.data.data.deals[].deal_descriptions` | `object \| null` | Yes | — | — |
| `result.data.data.deals[].deal_descriptions.short_description` | `string \| null` | No | — | Brief description of the deal |
| `result.data.data.deals[].deal_descriptions.long_description` | `string \| null` | No | — | Detailed description of the deal |
| `result.data.data.deals[].company_id` | `string` | Yes | — | Unique identifier for the company Format: `uuid`. |
| `result.data.data.deals[].investor_ids` | `array` | Yes | — | UUIDs of firm investors participating in this deal. Angels are surfaced separately in `angel_investor_ids`. |
| `result.data.data.deals[].angel_investor_ids` | `array` | Yes | — | UUIDs of angel investors (people) who participated in this deal. Resolve via `/people/{id}`. Empty array when no angels. |
| `result.data.data.deals[].financings` | `array` | Yes | — | Detailed financing information for deals that have multiple financing types |
| `result.data.data.deals[].financings[].id` | `string` | Yes | — | Unique identifier for the financing Format: `uuid`. |
| `result.data.data.deals[].financings[].type` | `"SEED" \| "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" \| "CONVERTIBLE_NOTE" \| "CROWDFUNDING" \| "DEBT_FINANCING" \| "EQUITY" \| "FUNDING_ROUND" \| "GRANT" \| "INITIAL_COIN_OFFERING" \| "NON_EQUITY_ASSISTANCE" \| "PREFERRED" \| "SAFE" \| "SECONDARY_MARKET"` | Yes | — | Type of financing Allowed: `SEED`, `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`, `CONVERTIBLE_NOTE`, `CROWDFUNDING`, `DEBT_FINANCING`, `EQUITY`, `FUNDING_ROUND`, `GRANT`, `INITIAL_COIN_OFFERING`, `NON_EQUITY_ASSISTANCE`, `PREFERRED`, `SAFE`, `SECONDARY_MARKET`. |
| `result.data.data.deals[].financings[].size_usd` | `number \| null` | No | — | Financing amount (USD) |
| `result.data.data.deals[].financings[].size_native` | `number \| null` | No | — | Financing amount in native currency |
| `result.data.data.deals[].financings[].currency` | `string \| null` | No | — | Currency of the original financing amount |
| `result.data.data.deals[].valuation` | `object \| null` | Yes | — | — |
| `result.data.data.deals[].valuation.valuation_currency` | `string \| null` | No | — | Currency of the valuation |
| `result.data.data.deals[].valuation.valuation_usd` | `number \| null` | No | — | Valuation amount (USD) |
| `result.data.data.deals[].valuation.valuation_native` | `number \| null` | No | — | Valuation amount in native currency |
| `result.data.data.deals[].valuation.type` | `"DEFAULT" \| "POST_MONEY" \| "PRE_MONEY"` | Yes | — | Type of valuation Allowed: `DEFAULT`, `POST_MONEY`, `PRE_MONEY`. |
| `result.data.data.deals[].articles` | `array` | Yes | — | Related articles/sources for this deal. Always included for every API tier. Empty when the deal has no related sources. |
| `result.data.data.deals[].articles[].link` | `string \| null` | No | — | URL of the article |
| `result.data.data.deals[].articles[].date` | `string \| null` | No | — | Date of the article |
| `result.data.data.deals[].articles[].is_primary` | `boolean` | Yes | — | Whether this is the primary source article for the deal |
| `result.data.meta` | `object` | Yes | — | — |
| `result.data.meta.total_count` | `integer` | No | — | Total number of deals matching the filter criteria |
| `result.data.meta.page` | `integer` | No | — | Current page number (0-based) |
| `result.data.meta.page_size` | `integer` | No | — | Number of results per page |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get fundable_search_deals --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.