> ## 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: Get Deal By ID
> Get a specific deal by ID. Includes SDK V2 and CLI requests, input constraints, response fields, and Deepline credit cost.
Get a specific deal by ID.
Tool ID: `fundable_get_deal_by_id`
## 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_get_deal_by_id',
{
"id": "123e4567-e89b-42d3-a456-426614174000"
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute fundable_get_deal_by_id --input '{
"id": "123e4567-e89b-42d3-a456-426614174000"
}' --json
```
## Example response
The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.
```json theme={null}
{
"data": {
"success": true,
"data": {},
"meta": {
"page": 123,
"page_size": 123
}
}
}
```
Use `deepline tools get fundable_get_deal_by_id --json` for the latest machine-readable contract.
## Input reference
Use this endpoint when a deal UUID is already known and full details for that one funding round are required. The response identifies related entities by ID rather than embedding their full profiles. Use `GET /company?id=...` for company metadata and `GET /deals/{id}/investors` for the complete investor lineup.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Unique identifier for the deal (UUID format) Format: `uuid`. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Use this endpoint when a deal UUID is already known and full details for that one funding round are required. The response identifies related entities by ID rather than embedding their full profiles. Use `GET /company?id=...` for company metadata and `GET /deals/{id}/investors` for the complete investor lineup.",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the deal (UUID format)",
"format": "uuid"
}
},
"required": [
"id"
],
"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.deal` | `object` | No | — | — |
| `result.data.data.deal.id` | `string` | Yes | — | Unique identifier for the deal Format: `uuid`. |
| `result.data.data.deal.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.deal.extension` | `boolean \| null` | Yes | — | Whether this is an extension round |
| `result.data.data.deal.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.deal.pre` | `boolean \| null` | Yes | — | Whether this is a pre-round (e.g., Pre-Series A) |
| `result.data.data.deal.date` | `string \| null` | Yes | — | Announcement date of the funding round Format: `date-time`. |
| `result.data.data.deal.created_at` | `string \| null` | Yes | — | Date the deal was added to the system Format: `date-time`. |
| `result.data.data.deal.total_round_raised` | `number \| null` | Yes | — | Total amount raised in the round (USD) |
| `result.data.data.deal.deal_descriptions` | `object \| null` | Yes | — | — |
| `result.data.data.deal.deal_descriptions.short_description` | `string \| null` | No | — | Brief description of the deal |
| `result.data.data.deal.deal_descriptions.long_description` | `string \| null` | No | — | Detailed description of the deal |
| `result.data.data.deal.company_id` | `string` | Yes | — | Unique identifier for the company Format: `uuid`. |
| `result.data.data.deal.investor_ids` | `array` | Yes | — | UUIDs of firm investors participating in this deal. Angels are surfaced separately in `angel_investor_ids`. |
| `result.data.data.deal.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.deal.financings` | `array` | Yes | — | Detailed financing information for deals that have multiple financing types |
| `result.data.data.deal.financings[].id` | `string` | Yes | — | Unique identifier for the financing Format: `uuid`. |
| `result.data.data.deal.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.deal.financings[].size_usd` | `number \| null` | No | — | Financing amount (USD) |
| `result.data.data.deal.financings[].size_native` | `number \| null` | No | — | Financing amount in native currency |
| `result.data.data.deal.financings[].currency` | `string \| null` | No | — | Currency of the original financing amount |
| `result.data.data.deal.valuation` | `object \| null` | Yes | — | — |
| `result.data.data.deal.valuation.valuation_currency` | `string \| null` | No | — | Currency of the valuation |
| `result.data.data.deal.valuation.valuation_usd` | `number \| null` | No | — | Valuation amount (USD) |
| `result.data.data.deal.valuation.valuation_native` | `number \| null` | No | — | Valuation amount in native currency |
| `result.data.data.deal.valuation.type` | `"DEFAULT" \| "POST_MONEY" \| "PRE_MONEY"` | Yes | — | Type of valuation Allowed: `DEFAULT`, `POST_MONEY`, `PRE_MONEY`. |
| `result.data.data.deal.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.deal.articles[].link` | `string \| null` | No | — | URL of the article |
| `result.data.data.deal.articles[].date` | `string \| null` | No | — | Date of the article |
| `result.data.data.deal.articles[].is_primary` | `boolean` | Yes | — | Whether this is the primary source article for the deal |
| `result.data.meta` | `object` | Yes | — | — |
| `result.data.meta.page` | `integer` | No | — | — |
| `result.data.meta.page_size` | `integer` | No | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"success": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"deal": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the deal",
"format": "uuid"
},
"round_type": {
"type": [
"string",
"null"
],
"description": "Type of funding round",
"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"
]
},
"extension": {
"type": [
"boolean",
"null"
],
"description": "Whether this is an extension round"
},
"intermediate": {
"type": [
"string",
"null"
],
"description": "Intermediate round designation",
"enum": [
"PLUS",
"NONE",
"ONE",
"TWO",
"THREE",
"FOUR",
"FIVE",
"SIX",
"SEVEN",
"EIGHT"
]
},
"pre": {
"type": [
"boolean",
"null"
],
"description": "Whether this is a pre-round (e.g., Pre-Series A)"
},
"date": {
"type": [
"string",
"null"
],
"description": "Announcement date of the funding round",
"format": "date-time"
},
"created_at": {
"type": [
"string",
"null"
],
"description": "Date the deal was added to the system",
"format": "date-time"
},
"total_round_raised": {
"type": [
"number",
"null"
],
"description": "Total amount raised in the round (USD)"
},
"deal_descriptions": {
"type": [
"object",
"null"
],
"properties": {
"short_description": {
"type": [
"string",
"null"
],
"description": "Brief description of the deal"
},
"long_description": {
"type": [
"string",
"null"
],
"description": "Detailed description of the deal"
}
},
"additionalProperties": false
},
"company_id": {
"type": "string",
"description": "Unique identifier for the company",
"format": "uuid"
},
"investor_ids": {
"type": "array",
"description": "UUIDs of firm investors participating in this deal. Angels are surfaced separately in `angel_investor_ids`.",
"items": {
"type": "string",
"format": "uuid"
}
},
"angel_investor_ids": {
"type": "array",
"description": "UUIDs of angel investors (people) who participated in this deal. Resolve via `/people/{id}`. Empty array when no angels.",
"items": {
"type": "string",
"format": "uuid"
}
},
"financings": {
"type": "array",
"description": "Detailed financing information for deals that have multiple financing types",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the financing",
"format": "uuid"
},
"type": {
"type": "string",
"description": "Type of financing",
"enum": [
"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"
]
},
"size_usd": {
"type": [
"number",
"null"
],
"description": "Financing amount (USD)"
},
"size_native": {
"type": [
"number",
"null"
],
"description": "Financing amount in native currency"
},
"currency": {
"type": [
"string",
"null"
],
"description": "Currency of the original financing amount"
}
},
"required": [
"id",
"type"
],
"additionalProperties": false
}
},
"valuation": {
"type": [
"object",
"null"
],
"properties": {
"valuation_currency": {
"type": [
"string",
"null"
],
"description": "Currency of the valuation"
},
"valuation_usd": {
"type": [
"number",
"null"
],
"description": "Valuation amount (USD)"
},
"valuation_native": {
"type": [
"number",
"null"
],
"description": "Valuation amount in native currency"
},
"type": {
"type": "string",
"description": "Type of valuation",
"enum": [
"DEFAULT",
"POST_MONEY",
"PRE_MONEY"
]
}
},
"required": [
"type"
],
"additionalProperties": false
},
"articles": {
"type": "array",
"description": "Related articles/sources for this deal. Always included for every API tier. Empty when the deal has no related sources.",
"items": {
"type": "object",
"description": "An article or source related to a deal",
"properties": {
"link": {
"type": [
"string",
"null"
],
"description": "URL of the article"
},
"date": {
"type": [
"string",
"null"
],
"description": "Date of the article"
},
"is_primary": {
"type": "boolean",
"description": "Whether this is the primary source article for the deal"
}
},
"required": [
"is_primary"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"round_type",
"extension",
"intermediate",
"pre",
"date",
"created_at",
"total_round_raised",
"deal_descriptions",
"company_id",
"investor_ids",
"angel_investor_ids",
"financings",
"valuation",
"articles"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"required": [
"success",
"data",
"meta"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## 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.