> ## 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 the full details of one funding round, such as amount, stage, date and related company and investor IDs, by its deal ID.
Get the full details of one funding round, such as amount, stage, date and related company and investor IDs, by its deal ID.
> [!NOTE]
>
> Tool ID: `fundable_get_deal_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.
```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute fundable_get_deal_by_id --input '{
"id": "123e4567-e89b-42d3-a456-426614174000"
}' --json
```
## Example response
The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"data": {
"success": true,
"data": {},
"meta": {
"page": 123,
"page_size": 123
}
}
}
```
Use `deepline describe 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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"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](https://deepline.com/docs/providers/fundable/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.